Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

New and Changed Features

• Enhanced SVG Mouse Event Support
• Oracle Spatial GeoRaster Support
• Oracle Spatial Network Data Model Support
• Oracle Spatial Topology Data Model Support
• Workspace Manager Support
• Multiple Data Sources in a Map Request
• Maps in SVG Formats (Basic, Compressed, and Tiny)
• Dynamic Coordinate System Transformation in a Map Request
• OGC WMS Protocol Support
• JPEG Format and Transparent PNG Map Support
• Container Data Source as the Map Data Source
• OracleAS MapViewer Configuration File Moved Inside the web.war File
• Label Styles in a Bucket-Based Advanced Style
• Style Enhancements
• Dynamically Defined (Temporary) Styles
• Bounding Themes Option for Restricting Displayed Data
• Performance Enhancements and Bug Fixes
• High Availability and OracleAS MapViewer
• Flash Map Support Deprecated

1 Introduction to OracleAS MapViewer

• 1.1 Overview of OracleAS MapViewer
• 1.1.1 Basic Flow of Action with OracleAS MapViewer
• 1.1.2 OracleAS MapViewer Architecture
• 1.2 Getting Started with OracleAS MapViewer
• 1.3 Prerequisite Software for OracleAS MapViewer
• 1.4 Installing and Deploying OracleAS MapViewer
• 1.4.1 Deploying OracleAS MapViewer in an Oracle Application Server Environment
• 1.4.1.1 URL Mappings for the Web Modules Page
• 1.4.1.2 Summary Page
• 1.4.1.3 Pages for Completing the Deployment
• 1.4.1.4 Configuring a Secure Administrator User for OracleAS MapViewer
• 1.4.2 Installing OracleAS MapViewer with a Standalone Installation of OC4J
• 1.4.2.1 Editing the OC4J Configuration Files to Autostart OracleAS MapViewer
• 1.4.2.2 Restarting OC4J
• 1.4.2.3 Running SQL Scripts, If Necessary
• 1.4.2.4 Verifying That the Deployment Was Successful
• 1.4.2.5 Checking the OracleAS MapViewer Administrator User Account
• 1.5 Configuring OracleAS MapViewer
• 1.5.1 Specifying Logging Information
• 1.5.2 Specifying Map File Storage and Life Cycle Information
• 1.5.3 Restricting Administrative (Non-Map) Requests
• 1.5.4 Specifying a Web Proxy for Background Image URLs
• 1.5.5 Specifying Global Map Configuration Options
• 1.5.6 Customizing the Spatial Data Cache
• 1.5.7 Defining Permanent Map Data Sources
• 1.6 High Availability and OracleAS MapViewer
• 1.6.1 Deploying OracleAS MapViewer on a Multiprocess OC4J Instance
• 1.6.2 Deploying OracleAS MapViewer on a Middle-Tier Cluster
• 1.7 Getting Started Using OracleAS MapViewer
• 1.7.1 Dynamically Defining OracleAS MapViewer Data Sources
• 1.7.2 Example JSP File That Uses OracleAS MapViewer
• 1.7.3 Additional JSP Example Files

2 OracleAS MapViewer Concepts

• 2.1 Overview of OracleAS MapViewer
• 2.2 Styles
• 2.2.1 Specifying a Label Style for a Bucket
• 2.2.2 Orienting Text Labels and Markers
• 2.2.2.1 Controlling Text Style Orientation
• 2.2.2.2 Controlling Marker Orientation
• 2.3 Themes
• 2.3.1 Predefined Themes
• 2.3.1.1 Styling Rules in Predefined Spatial Geometry Themes
• 2.3.1.2 Caching of Predefined Themes
• 2.3.2 JDBC Themes
• 2.3.2.1 Storing Complex JDBC Themes in the Database
• 2.3.3 Thematic Mapping
• 2.3.4 Attributes Affecting Theme Appearance
• 2.3.5 Image Themes
• 2.3.5.1 Creating Predefined Image Themes
• 2.3.6 GeoRaster Themes
• 2.3.6.1 Creating Predefined GeoRaster Themes
• 2.3.7 Network Themes
• 2.3.7.1 Creating Predefined Network Themes
• 2.3.7.2 Using OracleAS MapViewer for Network Analysis
• 2.3.8 Topology Themes
• 2.3.8.1 Creating Predefined Topology Themes
• 2.4 Maps
• 2.4.1 Map Size and Scale
• 2.4.2 Map Legend
• 2.5 Data Sources
• 2.6 How a Map Is Generated
• 2.7 Workspace Manager Support in OracleAS MapViewer
• 2.8 OracleAS MapViewer Metadata Views
• 2.8.1 xxx_SDO_MAPS Views
• 2.8.2 xxx_SDO_THEMES Views
• 2.8.3 xxx_SDO_STYLES Views

3 OracleAS MapViewer Map Request XML API

• 3.1 Map Request Examples
• 3.1.1 Simple Map Request
• 3.1.2 Map Request with Dynamically Defined Theme
• 3.1.3 Map Request with Base Map, Center, and Additional Predefined Theme
• 3.1.4 Map Request with Center, Base Map, Dynamically Defined Theme, and Other Features
• 3.1.5 Map Request for Point Features with Attribute Value and Dynamically Defined Variable Marker Style
• 3.1.6 Map Request with an Image Theme
• 3.1.7 Map Request for Image of Map Legend Only
• 3.1.8 Map Request with SRID Different from Data SRID
• 3.1.9 Map Request Using a Pie Chart Theme
• 3.1.10 Java Program Using OracleAS MapViewer
• 3.1.11 PL/SQL Program Using OracleAS MapViewer
• 3.2 Map Request DTD
• 3.2.1 map_request Element
• 3.2.1.1 map_request Attributes
• 3.2.2 bounding_themes Element
• 3.2.3 box Element
• 3.2.4 center Element
• 3.2.5 geoFeature Element
• 3.2.6 jdbc_georaster_query Element
• 3.2.7 jdbc_image_query Element
• 3.2.8 jdbc_network_query Element
• 3.2.9 jdbc_query Element
• 3.2.10 jdbc_topology_query Element
• 3.2.11 legend Element
• 3.2.12 style Element
• 3.2.13 styles Element
• 3.2.14 theme Element
• 3.2.15 themes Element
• 3.3 Information Request DTD
• 3.4 Map Response DTD
• 3.5 OracleAS MapViewer Exception DTD
• 3.6 Geometry DTD (OGC)

4 OracleAS MapViewer JavaBean-Based API

• 4.1 Usage Model for the OracleAS MapViewer JavaBean-Based API
• 4.2 Preparing to Use the OracleAS MapViewer JavaBean-Based API
• 4.3 Using the OracleAS MapViewer Bean
• 4.3.1 Creating the OracleAS MapViewer Bean
• 4.3.2 Setting Up Parameters of the Current Map Request
• 4.3.3 Adding Themes or Features to the Current Map Request
• 4.3.4 Adding Dynamically Defined Styles to a Map Request
• 4.3.5 Manipulating Themes in the Current Map Request
• 4.3.6 Sending a Request to the OracleAS MapViewer Service
• 4.3.7 Extracting Information from the Current Map Response
• 4.3.8 Obtaining Information About Data Sources
• 4.3.9 Querying Nonspatial Attributes in the Current Map Window
• 4.3.10 Using Optimal Methods for Thick Clients

5 OracleAS MapViewer JSP Tag Library

• 5.1 Using OracleAS MapViewer JSP Tags
• 5.2 OracleAS MapViewer JSP Tag Reference Information
• 5.2.1 addJDBCTheme
• 5.2.2 addPredefinedTheme
• 5.2.3 getMapURL
• 5.2.4 getParam
• 5.2.5 identify
• 5.2.6 importBaseMap
• 5.2.7 init
• 5.2.8 makeLegend
• 5.2.9 run
• 5.2.10 setParam
• 5.3 JSP Example (Several Tags) for OracleAS MapViewer

6 OracleAS MapViewer Administrative Requests

• 6.1 Managing Data Sources
• 6.1.1 Adding a Data Source
• 6.1.2 Removing a Data Source
• 6.1.3 Redefining a Data Source
• 6.1.4 Listing All Data Sources
• 6.1.5 Checking the Existence of a Data Source
• 6.2 Listing All Maps
• 6.3 Listing Themes
• 6.4 Listing Styles
• 6.5 Managing Cache
• 6.5.1 Clearing Metadata Cache for a Data Source
• 6.5.2 Clearing Spatial Data Cache for a Theme
• 6.6 Editing the OracleAS MapViewer Configuration File
• 6.7 Restarting the OracleAS MapViewer Server

7 Map Definition Tool

• 7.1 Overview of the Map Definition Tool
• 7.2 Connection Page
• 7.3 Styles: Color Page
• 7.4 Styles: Marker Page
• 7.5 Styles: Line Page
• 7.6 Styles: Area Page
• 7.7 Styles: Text Page
• 7.8 Styles: Advanced Page
• 7.9 Themes Page
• 7.10 Maps Page

A XML Format for Styles, Themes, and Base Maps

• A.1 Color Styles
• A.2 Marker Styles
• A.2.1 Vector Marker Styles
• A.2.2 Image Marker Styles
• A.2.3 Using Marker Styles on Lines
• A.3 Line Styles
• A.4 Area Styles
• A.5 Text Styles
• A.6 Advanced Styles
• A.6.1 Bucket Styles
• A.6.1.1 Collection-Based Buckets with Discrete Values
• A.6.1.2 Individual Range-Based Buckets
• A.6.1.3 Equal-Ranged Buckets
• A.6.2 Color Scheme Styles
• A.6.3 Variable Marker Styles
• A.7 Themes: Styling Rules
• A.8 Base Maps

B JavaScript Functions for SVG Maps

• B.1 Navigation Control Functions
• B.2 Display Control Functions
• B.3 Mouse-Click Event Control Functions
• B.3.1 Predefined Mouse-Click Control Functions
• B.3.2 User-Defined Mouse Event Control Functions
• B.3.2.1 Map-Level Functions
• B.3.2.2 Theme-Level Functions
• B.3.2.3 Selection Event Control Functions
• B.4 Other Control Functions

C Creating and Registering a Custom Image Renderer

D OGC WMS Support in OracleAS MapViewer

• D.1 Setting Up the WMS Interface for OracleAS MapViewer
• D.1.1 Required Files
• D.2 WMS Specification and Corresponding OracleAS MapViewer Concepts
• D.2.1 Supported GetMap Request Parameters
• D.2.1.1 BASEMAP Parameter (OracleAS MapViewer-Only)
• D.2.1.2 BBOX Parameter
• D.2.1.3 BGCOLOR Parameter
• D.2.1.4 DATASOURCE Parameter (OracleAS MapViewer-Only)
• D.2.1.5 DYNAMIC_STYLES Parameter (OracleAS MapViewer-Only)
• D.2.1.6 EXCEPTIONS Parameter
• D.2.1.7 FORMAT Parameter
• D.2.1.8 HEIGHT Parameter
• D.2.1.9 LAYERS Parameter
• D.2.1.10 LEGEND_REQUEST Parameter (OracleAS MapViewer-Only)
• D.2.1.11 MVTHEMES Parameter (OracleAS MapViewer-Only)
• D.2.1.12 REQUEST Parameter
• D.2.1.13 SERVICE Parameter
• D.2.1.14 SRS Parameter
• D.2.1.15 STYLES Parameter
• D.2.1.16 TRANSPARENT Parameter
• D.2.1.17 VERSION Parameter
• D.2.1.18 WIDTH Parameter
• D.2.2 Supported GetCapabilities Request and Response Features
• D.2.3 Supported GetFeatureInfo Request and Response Features
• D.2.3.1 GetMap Parameter Subset for GetFeatureInfo Requests
• D.2.3.2 EXCEPTIONS Parameter
• D.2.3.3 FEATURE_COUNT Parameter
• D.2.3.4 INFO_FORMAT Parameter
• D.2.3.5 QUERY_LAYERS Parameter
• D.2.3.6 QUERY_TYPE Parameter (OracleAS MapViewer-Only)
• D.2.3.7 RADIUS Parameter (OracleAS MapViewer-Only)
• D.2.3.8 UNIT Parameter (OracleAS MapViewer-Only)
• D.2.3.9 X and Y Parameters
• D.2.3.10 Specifying Attributes to Be Queried for a GetFeatureInfo Request
• D.3 Adding a WMS Map Theme
• D.3.1 XML API for Adding a WMS Map Theme
• D.3.2 JavaBean-Based API for Adding a WMS Map Theme

Index