Skip Headers
Oracle® Application Server MapViewer User's Guide
Release 10.1.3.1
B14036-03
Home
Solution Area
Index
Next
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
Oracle Maps Feature
Oracle Map Builder Tool
Enhanced Map Labeling
PL/SQL API: SDO_MVCLIENT Package
New Advanced Style Types: Dot Density, Bar Chart, Collection
TrueType Font Symbol Support
Custom (External) Attribute Data Provider Support
Map Scale Bars
Theme-Wide Transparency
Embedded Geometries and Label Text
WMS Service Enhancements
Image Processing Operations with GeoRaster Themes
Client-Side Style Creation
Theme Modifiers for Base Map Themes
Sample Image of Any Style
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.2
Installing OracleAS MapViewer with a Standalone Installation of OC4J
1.4.3
After Deploying MapViewer
1.4.3.1
Verifying That the Deployment Was Successful
1.4.3.2
Running SQL Scripts
1.5
Administering MapViewer
1.5.1
Logging in to the MapViewer Administration Page
1.5.2
Configuring OracleAS 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
Customizing WMS GetCapabilities Responses
1.5.2.10
Registering Custom Nonspatial Data Providers
1.5.2.11
Configuring the Map Cache Server for Oracle Maps
1.5.2.12
Defining Permanent Map Data Sources
1.5.3
Performing MapViewer Administrative Tasks
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
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.2.3
Making a Text Style Sticky
2.2.4
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
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.3.1
Thematic Mapping Using External Attribute Data
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
Map Request Using Ratio Scale and Mixed Theme Scale Modes
3.1.11
Java Program Using OracleAS MapViewer
3.1.12
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
map_cache_theme Element
3.2.13
style Element
3.2.14
styles Element
3.2.15
theme Element
3.2.16
themes Element
3.2.17
theme_modifiers Element
3.2.18
parameter Element
3.2.19
operation Element
3.2.20
operations 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 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
OracleAS MapViewer Administrative Requests
7.1
Managing Data Sources
7.1.1
Adding a Data Source
7.1.2
Removing a Data Source
7.1.3
Redefining a Data Source
7.1.4
Listing All Data Sources
7.1.5
Checking the Existence of a Data Source
7.2
Listing All Maps
7.3
Listing Themes
7.4
Listing Styles
7.5
Managing Cache
7.5.1
Clearing Metadata Cache for a Data Source
7.5.2
Clearing Spatial Data Cache for a Theme
7.6
Editing the OracleAS MapViewer Configuration File
7.7
Restarting the OracleAS MapViewer Server
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
Base Map 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 Cache Server
8.2.1
Map Cache Server Concepts
8.2.1.1
Map Cache Instances and Base Map 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 Cache Server Configuration
8.2.2.1
Global Map Cache Server Configuration
8.2.2.2
Map Cache Instance 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 Cache Instances
8.5.2
Defining FOI Metadata
8.5.3
Creating the Client Application
9
Oracle Map Builder Tool
9.1
Running Oracle Map Builder
9.2
Oracle Map Builder User Interface
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
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.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.1.2
Data Source Named wms
D.1.3
SDO to EPSG SRID Mapping File
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