Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Send Us Your Comments

Preface

Documentation Accessibility

Related Documentation

New and Changed Features

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

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 MapViewer

Flash Map Support Deprecated

1 Introduction to MapViewer

1.1 Overview of MapViewer

1.1.1 Basic Flow of Action with MapViewer

1.1.2 MapViewer Architecture

1.2 Getting Started with MapViewer

1.3 Prerequisite Software for MapViewer

1.4 Installing and Deploying MapViewer

1.4.1 Deploying 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 MapViewer

1.4.2 Installing MapViewer with a Standalone Installation of OC4J

1.4.2.1 Editing the OC4J Configuration Files to Autostart 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 MapViewer Administrator User Account

1.5 Configuring 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 MapViewer

1.6.1 Deploying MapViewer on a Multiprocess OC4J Instance

1.6.2 Deploying MapViewer on a Middle-Tier Cluster

1.7 Getting Started Using MapViewer

1.7.1 Dynamically Defining MapViewer Data Sources

1.7.2 Example JSP File That Uses MapViewer

1.7.3 Additional JSP Example Files

2 MapViewer Concepts

2.1 Overview of MapViewer

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.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 MapViewer for Network Analysis

2.3.8 Topology Themes

2.3.8.1 Creating Predefined Topology Themes

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 MapViewer

2.8 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 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 MapViewer

3.1.11 PL/SQL Program Using 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 MapViewer Exception DTD

3.6 Geometry DTD (OGC)

4 MapViewer JavaBean-Based API

4.1 Usage Model for the MapViewer JavaBean-Based API

4.2 Preparing to Use the MapViewer JavaBean-Based API

4.3 Using the MapViewer Bean

4.3.1 Creating the 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 MapViewer Service

4.3.7 Extracting Information from the Current Map Response

4.3.8 Using Data Source Methods

4.3.9 Querying Nonspatial Attributes in the Current Map Window

4.3.10 Using Optimal Methods for Thick Clients

5 MapViewer JSP Tag Library

5.1 Using MapViewer JSP Tags

5.2 MapViewer JSP Tag Reference Information

5.2.1 addJDBCTheme

5.2.2 addPredefinedTheme

5.2.3 getMapURL

5.2.6 importBaseMap

5.2.8 makeLegend

5.2.10 setParam

5.3 JSP Example (Several Tags) for MapViewer

6 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 MapViewer Configuration File

6.7 Restarting the 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

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

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-Click Control Functions

B.3.2.1 Map-Level Functions

B.3.2.2 Theme-Level Functions

B.3.2.3 Selection Event Control Functions

C Creating and Registering a Custom Image Renderer

D OGC WMS Support in MapViewer

D.1 Setting Up the WMS Interface for MapViewer

D.1.1 Required Files

D.2 WMS Specification and Corresponding MapViewer Concepts

D.2.1 Supported GetMap Request Parameters

D.2.1.1 BASEMAP Parameter (MapViewer-Only)

D.2.1.2 BBOX Parameter

D.2.1.3 BGCOLOR Parameter

D.2.1.4 DATASOURCE Parameter (MapViewer-Only)

D.2.1.5 DYNAMIC_STYLES Parameter (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 (MapViewer-Only)

D.2.1.11 MVTHEMES Parameter (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 (MapViewer-Only)

D.2.3.7 RADIUS Parameter (MapViewer-Only)

D.2.3.8 UNIT Parameter (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