Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documentation
• Conventions

New and Changed Features

• MapViewer Core
• Oracle Maps

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 a WebLogic Server Environment
    • 1.4.1.1 Unpacking the MapViewer EAR Archive
    • 1.4.1.2 Configuring WebLogic Server
    • 1.4.1.3 Deploying and Starting MapViewer in WebLogic Server
    • 1.4.1.4 Using the MapViewer Administration Page
  • 1.4.2 Deploying MapViewer in an Oracle Fusion Middleware 10gR3 Environment
  • 1.4.3 Installing MapViewer with a Standalone Installation of OC4J
  • 1.4.4 After Deploying MapViewer
    • 1.4.4.1 Verifying That the Deployment Was Successful
    • 1.4.4.2 Running SQL Scripts
    • 1.4.4.3 Creating MapViewer Array Types, if Necessary
• 1.5 Administering MapViewer
  • 1.5.1 Logging in to the MapViewer Administration Page
  • 1.5.2 Configuring MapViewer
    • 1.5.2.1 Specifying Logging Information
    • 1.5.2.2 Specifying Map File Storage and Life Cycle Information
    • 1.5.2.3 Restricting Administrative (Non-Map) Requests
    • 1.5.2.4 Specifying a Web Proxy
    • 1.5.2.5 Specifying Global Map Configuration Options
    • 1.5.2.6 Customizing the Spatial Data Cache
    • 1.5.2.7 Specifying the Security Configuration
    • 1.5.2.8 Registering a Custom Image Renderer
    • 1.5.2.9 Registering a Custom Spatial Provider
    • 1.5.2.10 Registering Custom Nonspatial Data Providers
    • 1.5.2.11 Customizing SRS Mapping
    • 1.5.2.12 Customizing WMS GetCapabilities Responses
    • 1.5.2.13 Configuring the Map Tile Server for Oracle Maps
    • 1.5.2.14 Defining Permanent Map Data Sources
  • 1.5.3 Performing MapViewer Administrative Tasks
• 1.6 Oracle Real Application Clusters and MapViewer
  • 1.6.1 Creating a Container Oracle RAC Data Source
  • 1.6.2 Adding the userThreads Option to the OC4J Container
    • 1.6.2.1 Adding userThreads for a Standalone OC4J Instance
    • 1.6.2.2 Adding userThreads for a Full Oracle Fusion Middleware 10gR3 Installation
  • 1.6.3 Creating a MapViewer Data Source
• 1.7 High Availability and MapViewer
  • 1.7.1 Deploying MapViewer on a Multiprocess OC4J Instance
  • 1.7.2 Deploying MapViewer on a Middle-Tier Cluster
• 1.8 Secure Map Rendering
  • 1.8.1 How Secure Map Rendering Works
  • 1.8.2 Getting the User Name from a Cookie
  • 1.8.3 Authenticating Users: Options and Demo
• 1.9 MapViewer Demos and Tutorials

2 MapViewer Concepts

• 2.1 Overview of MapViewer
• 2.2 Styles
  • 2.2.1 Scaling the Size of a Style (Scalable Styles)
  • 2.2.2 Specifying a Label Style for a Bucket
  • 2.2.3 Orienting Text Labels and Markers
    • 2.2.3.1 Controlling Text Style Orientation
    • 2.2.3.2 Controlling Marker Orientation
  • 2.2.4 Making a Text Style Sticky
  • 2.2.5 Getting a Sample Image of Any Style
• 2.3 Themes
  • 2.3.1 Predefined Themes
    • 2.3.1.1 Styling Rules in Predefined Spatial Geometry Themes
    • 2.3.1.2 How MapViewer Formulates a SQL Query for a Styling Rule
    • 2.3.1.3 Styling Rules with Binding Parameters
    • 2.3.1.4 Applying Multiple Rendering Styles in a Single Styling Rule
    • 2.3.1.5 Caching of Predefined Themes
    • 2.3.1.6 Feature Labels and Internationalization
  • 2.3.2 JDBC Themes
    • 2.3.2.1 Defining a Point JDBC Theme Based on Two Columns
    • 2.3.2.2 Storing Complex JDBC Themes in the Database
  • 2.3.3 Image Themes
    • 2.3.3.1 Creating Predefined Image Themes
  • 2.3.4 GeoRaster Themes
    • 2.3.4.1 Creating Predefined GeoRaster Themes
    • 2.3.4.2 Using Bitmap Masks with GeoRaster Themes
    • 2.3.4.3 Reprojection of GeoRaster Themes
  • 2.3.5 Network Themes
    • 2.3.5.1 Creating Predefined Network Themes
    • 2.3.5.2 Using MapViewer for Network Analysis
  • 2.3.6 Topology Themes
    • 2.3.6.1 Creating Predefined Topology Themes
  • 2.3.7 WFS Themes
    • 2.3.7.1 Creating Predefined WFS Themes
  • 2.3.8 Custom Geometry Themes
  • 2.3.9 Annotation Text Themes
  • 2.3.10 Thematic Mapping
    • 2.3.10.1 Thematic Mapping Using External Attribute Data
  • 2.3.11 Attributes Affecting Theme Appearance
• 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 Cross-Schema Map Requests
• 2.8 Workspace Manager Support in MapViewer
• 2.9 MapViewer Metadata Views
  • 2.9.1 xxx_SDO_MAPS Views
  • 2.9.2 xxx_SDO_THEMES Views
  • 2.9.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 Map Request Using Ratio Scale and Mixed Theme Scale Modes
  • 3.1.11 Map Request Using Predefined Theme (Binding Parameter and Custom Type)
  • 3.1.12 Map Request Using Advanced Styles and Rendering Rules
  • 3.1.13 Map Request Using Stacked Styles
  • 3.1.14 WFS Map Requests
  • 3.1.15 Java Program Using MapViewer
  • 3.1.16 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 map_tile_theme Element
  • 3.2.13 north_arrow Element
  • 3.2.14 operation Element
  • 3.2.15 operations Element
  • 3.2.16 parameter Element
  • 3.2.17 scale_bar Element
  • 3.2.18 style Element
  • 3.2.19 styles Element
  • 3.2.20 theme Element
  • 3.2.21 themes Element
  • 3.2.22 theme_modifiers 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 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 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.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 MapViewer

6 MapViewer PL/SQL API

• 6.1 Installing the SDO_MVCLIENT Package
• 6.2 Using the SDO_MVCLIENT Package
  • 6.2.1 Granting Network Access
  • 6.2.2 Creating a MapViewer Client Handle
  • 6.2.3 Preparing a Map Request
  • 6.2.4 Sending the Request to the MapViewer Service
  • 6.2.5 Extracting Information from the Map Request

7 MapViewer XML Requests: Administrative and Other

• 7.1 Managing Data Sources
  • 7.1.1 Adding a Data Source (Administrative)
  • 7.1.2 Removing a Data Source (Administrative)
  • 7.1.3 Redefining a Data Source
  • 7.1.4 Listing All Data Sources (Administrative or General-Purpose)
  • 7.1.5 Checking the Existence of a Data Source (General-Purpose)
• 7.2 Listing All Maps (General-Purpose)
• 7.3 Listing Themes (General-Purpose)
• 7.4 Listing Styles (General-Purpose)
• 7.5 Listing Styles Used by a Predefined Theme (General-Purpose)
• 7.6 Managing In-Memory Caches
  • 7.6.1 Clearing Metadata Cache for a Data Source (Administrative)
  • 7.6.2 Clearing Spatial Data Cache for a Theme (Administrative)
• 7.7 Editing the MapViewer Configuration File (Administrative)
• 7.8 Restarting the MapViewer Server (Administrative)

8 Oracle Maps

• 8.1 Overview of Oracle Maps
  • 8.1.1 Architecture for Oracle Maps Applications
  • 8.1.2 Simple Example Using Oracle Maps
  • 8.1.3 How Map Content Is Organized
    • 8.1.3.1 Map Tile Layers
    • 8.1.3.2 Theme-Based FOI Layers
    • 8.1.3.3 User-Defined FOI Layers
    • 8.1.3.4 Information Window Layer
    • 8.1.3.5 Fixed Figures Layer
• 8.2 Map Tile Server
  • 8.2.1 Map Tile Server Concepts
    • 8.2.1.1 Map Tile Layers and Map Tile Sources
    • 8.2.1.2 Storage of Map Image Tiles
    • 8.2.1.3 Coordinate System for Map Tiles
    • 8.2.1.4 Tile Mesh Codes
    • 8.2.1.5 Tiling Rules
  • 8.2.2 Map Tile Server Configuration
    • 8.2.2.1 Global Map Tile Server Configuration
    • 8.2.2.2 Map Tile Layer Configuration
  • 8.2.3 External Map Source Adapter
• 8.3 Feature of Interest (FOI) Server
  • 8.3.1 Theme-Based FOI Layers
    • 8.3.1.1 Predefined Theme-Based FOI Layers
    • 8.3.1.2 Templated Predefined Themes
    • 8.3.1.3 Dynamic JDBC Query Theme-Based FOI Layers
  • 8.3.2 User-Defined FOI Requests
• 8.4 Oracle Maps JavaScript API
• 8.5 Developing Oracle Maps Applications
  • 8.5.1 Creating One or More Map Tile Layers
  • 8.5.2 Defining FOI Metadata
  • 8.5.3 Creating the Client Application
• 8.6 Built-in Map Tile Layers (Google Maps and Bing Maps)
  • 8.6.1 Defining the Built-in Map Tile Layers on the Client Side
  • 8.6.2 Defining the Built-In Map Tile Layers on the Server Side
• 8.7 Transforming Data to a Spherical Mercator Coordinate System
  • 8.7.1 Creating a Transformation Rule to Skip Datum Conversion

9 Oracle Map Builder Tool

• 9.1 Running Oracle Map Builder
• 9.2 Oracle Map Builder User Interface

A XML Format for Styles, Themes, Base Maps, and Map Tile Layers

• A.1 Color Styles
• A.2 Marker Styles
  • A.2.1 Vector Marker Styles
  • A.2.2 Image Marker Styles
  • A.2.3 TrueType Font-Based Marker Styles
  • A.2.4 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.6.4 Dot Density Marker Styles
  • A.6.5 Bar Chart Marker Styles
  • A.6.6 Collection Styles
  • A.6.7 Variable Pie Chart Styles
  • A.6.8 Heat Map Styles
• A.7 Themes: Styling Rules
• A.8 Base Maps
• A.9 Map Tile Layers

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 Creating and Registering a Custom Spatial Data Provider

• D.1 Implementing the Spatial Provider Class
• D.2 Registering the Spatial Provider with MapViewer
• D.3 Rendering the External Spatial Data

E OGC WMS Support in MapViewer

• E.1 Setting Up the WMS Interface for MapViewer
  • E.1.1 Required Files
  • E.1.2 Data Source Named wms
  • E.1.3 SDO to EPSG SRID Mapping File
• E.2 WMS Specification and Corresponding MapViewer Concepts
  • E.2.1 Supported GetMap Request Parameters
    • E.2.1.1 BASEMAP Parameter (MapViewer-Only)
    • E.2.1.2 BBOX Parameter
    • E.2.1.3 BGCOLOR Parameter
    • E.2.1.4 DATASOURCE Parameter (MapViewer-Only)
    • E.2.1.5 DYNAMIC_STYLES Parameter (MapViewer-Only)
    • E.2.1.6 EXCEPTIONS Parameter
    • E.2.1.7 FORMAT Parameter
    • E.2.1.8 HEIGHT Parameter
    • E.2.1.9 LAYERS Parameter
    • E.2.1.10 LEGEND_REQUEST Parameter (MapViewer-Only)
    • E.2.1.11 MVTHEMES Parameter (MapViewer-Only)
    • E.2.1.12 REQUEST Parameter
    • E.2.1.13 SERVICE Parameter
    • E.2.1.14 SRS (1.1.1) or CRS (1.3.0) Parameter
    • E.2.1.15 STYLES Parameter
    • E.2.1.16 TRANSPARENT Parameter
    • E.2.1.17 VERSION Parameter
    • E.2.1.18 WIDTH Parameter
  • E.2.2 Supported GetCapabilities Request and Response Features
  • E.2.3 Supported GetFeatureInfo Request and Response Features
    • E.2.3.1 GetMap Parameter Subset for GetFeatureInfo Requests
    • E.2.3.2 EXCEPTIONS Parameter
    • E.2.3.3 FEATURE_COUNT Parameter
    • E.2.3.4 INFO_FORMAT Parameter
    • E.2.3.5 QUERY_LAYERS Parameter
    • E.2.3.6 QUERY_TYPE Parameter (MapViewer-Only)
    • E.2.3.7 RADIUS Parameter (MapViewer-Only)
    • E.2.3.8 UNIT Parameter (MapViewer-Only)
    • E.2.3.9 X and Y or I and J Parameters
    • E.2.3.10 Specifying Attributes to Be Queried for a GetFeatureInfo Request
• E.3 Adding a WMS Map Theme
  • E.3.1 XML API for Adding a WMS Map Theme
  • E.3.2 Predefined WMS Map Theme Definition
  • E.3.3 Authentication with WMS Map Themes
  • E.3.4 JavaBean-Based API for Adding a WMS Map Theme

Index