1/22
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 10
g
R3 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 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 10
g
R3 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.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
Transforming Data to a Spherical Mercator Coordinate System
8.6.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
JavaBean-Based API for Adding a WMS Map Theme
Index
Scripting on this page enhances content navigation, but does not change the content in any way.