Home
/
Middleware
1/23
Contents
List of Examples
List of Figures
List of Tables
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documentation
Acknowledgments
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 in WebLogic Server 12
c
1.4.1
Deploying MapViewer Using the Universal Installer
1.4.1.1
Installing WebLogic Server
1.4.1.2
Creating Required JRF Components Using the Repository Creation Utility
1.4.1.3
Installing MapViewer Using the Universal Installer
1.4.1.4
Configuring WebLogic Server
1.4.1.5
Starting WebLogic Server and Configuring MapViewer
1.4.2
Manually Deploying an Exploded MapViewer EAR Folder in WebLogic Server
1.4.2.1
Prerequisites for Manually Deploying MapViewer
1.4.2.2
Unpacking the MapViewer EAR File into a Folder
1.4.2.3
Deploying MapViewer from an Exploded EAR File
1.4.3
Manually Deploying an Unexploded MapViewer EAR File in WebLogic Server
1.4.3.1
Preparing to Install MapViewer From an Unexploded EAR File
1.4.3.2
Installing MapViewer from an Unexploded EAR File
1.4.4
After Deploying MapViewer
1.4.4.1
Verifying If the Deployment Was Successful
1.4.4.2
Running SQL Scripts
1.4.4.3
Creating MapViewer Array Types (If Necessary)
1.5
Upgrading MapViewer
1.5.1
Shutting Down the Old WebLogic Server
1.5.2
Deploying MapViewer in WebLogic Server 12
c
1.5.3
Running the Upgrade Assistant Wizard
1.6
Administering MapViewer
1.6.1
Logging in to the MapViewer Administration Page
1.6.2
Configuring MapViewer
1.6.2.1
Specifying Logging Information
1.6.2.2
Specifying Map File Storage and Life Cycle Information
1.6.2.3
Restricting Administrative (Non-Map) Requests
1.6.2.4
Specifying a Web Proxy
1.6.2.5
Specifying Global Map Configuration Options
1.6.2.6
Customizing the Spatial Data Cache
1.6.2.7
Specifying the Security Configuration
1.6.2.8
Registering a Custom Image Renderer
1.6.2.9
Registering a Custom Spatial Provider
1.6.2.10
Registering Custom Nonspatial Data Providers
1.6.2.11
Customizing SRS Mapping
1.6.2.12
Customizing WMS GetCapabilities Responses
1.6.2.13
Customizing WMTS GetCapabilities Responses
1.6.2.14
Configuring the Map Tile Server for Oracle Maps
1.6.2.15
Defining Permanent Map Data Sources
1.6.2.16
Configuring and Securing the Map Data Server for the HTML5 API
1.6.3
Performing MapViewer Administrative Tasks
1.7
Oracle Real Application Clusters and MapViewer
1.7.1
Creating a Container Oracle RAC Data Source for the MapViewer Server
1.7.1.1
Create a Container Oracle RAC Data Source
1.7.1.2
Create a MapViewer Data Source Using a Container Data Source
1.7.2
Creating a MapViewer Data Source Using the Oracle RAC Service Name
1.7.3
Restarting MapViewer
1.8
High Availability and MapViewer
1.8.1
Deploying MapViewer on a Multiprocess OC4J Instance
1.8.2
Deploying MapViewer on a Middle-Tier Cluster
1.9
Secure Map Rendering
1.9.1
How Secure Map Rendering Works
1.9.2
Getting the User Name from a Cookie
1.9.3
Authenticating Users: Options and Demo
1.9.4
Using Single Sign-On (SSO) with MapViewer
1.9.4.1
Install Oracle Access Manager
1.9.4.2
Configure MapViewer
1.9.4.3
Configure Oracle Access Manager
1.9.4.4
Configure Oracle HTTP Server
1.10
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
Using Multiple Rendering Styles with Scale Ranges
2.3.1.6
Caching of Predefined Themes
2.3.1.7
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
WMTS Themes
2.3.8.1
How the tile_resizing_option Attribute Works
2.3.8.2
snap_to_tile_scale and tile_resizing_option Attribute Usage Guidelines
2.3.8.3
Creating Predefined WMTS Themes
2.3.9
Custom Geometry Themes
2.3.10
Annotation Text Themes
2.3.11
LRS (Linear Referencing System) Themes
2.3.12
Thematic Mapping
2.3.12.1
Thematic Mapping Using External Attribute Data
2.3.13
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_STYLES Views
2.9.2
xxx_SDO_THEMES Views
2.9.3
xxx_SDO_MAPS Views
2.9.4
xxx_SDO_CACHED_MAPS Views
2.10
Oracle Maps
2.10.1
Overview of Oracle Maps
2.10.2
Architecture for Oracle Maps Applications
3
MapViewer Servers
3.1
MapViewer Map Server
3.1.1
Map Request Examples
3.1.1.1
Simple Map Request
3.1.1.2
Map Request with Dynamically Defined Theme
3.1.1.3
Map Request with Base Map, Center, and Additional Predefined Theme
3.1.1.4
Map Request with Center, Base Map, Dynamically Defined Theme, and Other Features
3.1.1.5
Map Request for Point Features with Attribute Value and Dynamically Defined Variable Marker Style
3.1.1.6
Map Request with an Image Theme
3.1.1.7
Map Request for Image of Map Legend Only
3.1.1.8
Map Request with SRID Different from Data SRID
3.1.1.9
Map Request Using a Pie Chart Theme
3.1.1.10
Map Request Using Ratio Scale and Mixed Theme Scale Modes
3.1.1.11
Map Request Using Predefined Theme (Binding Parameter and Custom Type)
3.1.1.12
Map Request Using Advanced Styles and Rendering Rules
3.1.1.13
Map Request Using Stacked Styles
3.1.1.14
WFS Map Requests
3.1.1.15
Java Program Using MapViewer
3.1.1.16
PL/SQL Program Using MapViewer
3.1.2
Map Request DTD
3.1.2.1
map_request Element
3.1.2.2
bounding_themes Element
3.1.2.3
box Element
3.1.2.4
center Element
3.1.2.5
geoFeature Element
3.1.2.6
jdbc_georaster_query Element
3.1.2.7
jdbc_image_query Element
3.1.2.8
jdbc_network_query Element
3.1.2.9
jdbc_query Element
3.1.2.10
jdbc_topology_query Element
3.1.2.11
legend Element
3.1.2.12
map_tile_theme Element
3.1.2.13
north_arrow Element
3.1.2.14
operation Element
3.1.2.15
operations Element
3.1.2.16
parameter Element
3.1.2.17
scale_bar Element
3.1.2.18
style Element
3.1.2.19
styles Element
3.1.2.20
theme Element
3.1.2.21
themes Element
3.1.2.22
theme_modifiers Element
3.1.3
Information Request DTD
3.1.4
Map Response DTD
3.1.5
MapViewer Exception DTD
3.1.6
Geometry DTD (OGC)
3.2
MapViewer Map Data Server
3.2.1
Domains and Map Data Server URL Patterns
3.2.2
Map Data Server Request Parameters
3.2.2.1
Getting Data from a Predefined Geometry Theme
3.2.2.2
Getting Data from a JDBC Theme
3.2.2.3
Getting Annotation Text from a JDBC Theme
3.2.2.4
Getting Topology Data
3.2.3
Interpreting Data Returned from the Map Data Server
3.2.4
Map Data Server Error Handling
3.3
Map Tile Server
3.3.1
Map Tile Server Concepts
3.3.1.1
Map Tile Layers and Map Tile Sources
3.3.1.2
Storage of Map Image Tiles
3.3.1.3
Coordinate System for Map Tiles
3.3.1.4
Tile Mesh Codes
3.3.1.5
Tiling Rules
3.3.1.6
Tile Background Color and Out-of-Bounds Color
3.3.2
Map Tile Server Configuration
3.3.2.1
Global Map Tile Server Configuration
3.3.2.2
Map Tile Layer Configuration
3.3.2.3
Map Tile Storage Schemes: Internal Mesh Code or XYZ
3.3.2.4
Creating a Map Tile Layer Using an External Web Map Source
3.3.3
Map Cache Auto-Update
3.3.3.1
Add the <dirty_tile_auto_update> element to the mapViewerConfig.xml configuration file
3.3.3.2
Add the <auto_update> element to tile layer definition
3.3.3.3
Create the dirty MBR table, base tables' log table, and triggers
3.3.3.4
Start the MapViewer server and test the map cache auto-update feature
3.3.4
UTFGrid for Map Tiles: Including Text Information About Features
3.3.4.1
Enabling the UTFGrid Option for a Tile Layer
3.3.4.2
Encoding a Key and Decoding a Grid Cell's Value
3.3.4.3
Building a UTFGrid Test Case
3.3.5
External Map Source Adapter
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 XML Requests: Administrative and Other
5.1
Managing Data Sources
5.1.1
Adding a Data Source (Administrative)
5.1.2
Removing a Data Source (Administrative)
5.1.3
Redefining a Data Source
5.1.4
Listing All Data Sources (Administrative or General-Purpose)
5.1.5
Checking the Existence of a Data Source (General-Purpose)
5.2
Managing Tile Layers
5.2.1
Getting Client Side Configuration
5.2.2
Getting Cache Status
5.2.3
Clearing, Prefetching, or Refreshing Cache
5.2.4
Zipping Tile Cache for Downloading
5.2.5
Stopping, Resuming, or Removing an Existing Cache Administrative Task
5.2.6
Getting the Status of an Administrative Request
5.2.7
Creating or Redefining a Cache Instance
5.2.8
Removing a Cache Instance
5.2.9
Restarting the Tile Layer Cache Server
5.2.10
Taking a Tile Layer Offline or Bringing It Online
5.3
Listing All Maps (General-Purpose)
5.4
Listing Themes (General-Purpose)
5.5
Listing Styles (General-Purpose)
5.6
Listing Styles Used by a Predefined Theme (General-Purpose)
5.7
Getting Style Definitions (General-Purpose)
5.8
Managing In-Memory Caches
5.8.1
Clearing Metadata Cache for a Data Source (Administrative)
5.8.2
Clearing Spatial Data Cache for a Theme (Administrative)
5.9
Editing the MapViewer Configuration File (Administrative)
5.10
Restarting the MapViewer Server (Administrative)
6
Oracle Maps
6.1
Feature of Interest (FOI) Server
6.1.1
Theme-Based FOI Layers
6.1.1.1
Predefined Theme-Based FOI Layers
6.1.1.2
Templated Predefined Themes
6.1.1.3
Dynamic JDBC Query Theme-Based FOI Layers
6.1.2
User-Defined FOI Requests
6.2
Map Templates
6.3
Oracle Maps JavaScript API
6.3.1
JavaScript API V1
6.3.2
JavaScript API V2
6.3.3
V1 and V2 APIs: Similarities and Differences
6.4
Developing Oracle Maps Applications
6.4.1
Using the V1 API
6.4.1.1
Creating One or More Map Tile Layers
6.4.1.2
Defining FOI Metadata
6.4.1.3
Creating the Client Application with the V1 API
6.4.2
Using the V2 API
6.4.2.1
Creating the Client Application with the V2 API
6.4.2.2
Loading a Map Template with the V2 API
6.5
Using Google Maps and Bing Maps
6.5.1
Defining Google Maps and Bing Maps Tile Layers on the Client Side
6.5.2
Defining the Built-In Map Tile Layers on the Server Side
6.6
Transforming Data to a Spherical Mercator Coordinate System
6.6.1
Creating a Transformation Rule to Skip Datum Conversion
6.7
Dynamically Displaying an External Tile Layer
7
Oracle Map Builder Tool
7.1
Running Oracle Map Builder
7.2
Oracle Map Builder User Interface
7.3
Map Builder Web Version
8
Oracle MapViewer Editor
8.1
MapViewer Editor Concepts and Usage
8.1.1
About the MapViewer Editor
8.1.2
MapViewer Editor Main Window
8.1.3
Editing Sessions
8.1.3.1
Editing Mode
8.1.3.2
Security and Multiuser Editing Considerations
8.1.4
Getting Started: A Typical Workflow
8.1.4.1
Installing the USER_SDO_EDIT_SESSIONS View
8.1.4.2
Making a MapViewer Data Source Editable
8.1.4.3
Allowing Map Data Server Data Streaming
8.1.4.4
Launching the MapViewer Editor and Logging In
8.1.4.5
Selecting a Data Source and Creating a New Session
8.1.4.6
Adding Data Layers to a Session
8.1.4.7
Changing Data Layer Properties
8.1.4.8
Navigating the Map and Enabling Editing Mode
8.1.4.9
Selecting a Feature for Editing
8.1.4.10
Saving and Merging Session Edits
8.1.5
Known Issues
8.2
MapViewer Editor Reference
8.2.1
Session and Layer Preferences
8.2.1.1
<session-name> Properties
8.2.1.2
Control Layer Properties
8.2.1.3
Data Layer Properties
8.2.2
Edit Session Area
8.2.2.1
Session and Data Layer Operations Toolbar
8.2.2.2
Data Layers
8.2.2.3
Rendering Properties
8.2.2.4
Labeling Properties
8.2.3
Map Canvas Area
8.2.3.1
Navigation Panel
8.2.3.2
Map Scale Bar
8.2.4
Tools Area
8.2.4.1
Feature Tools
8.2.4.2
Drawing Tools
8.2.4.3
Vertex Tools
8.2.4.4
Grouping Tools
8.2.4.5
Geometry Tools
8.2.4.6
Transformation Tools
9
Oracle MapViewer Template Builder
9.1
Template Builder User Interface
9.2
Creating or Editing a Map Template
9.3
Creating Vector Layers
9.4
Adding Vector Layers to a Map Template
9.5
Adding Styles to a Map Template
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
E.3.5
Customizing GetCapabilities Responses: Additional Options
E.3.5.1
Custom WMS Capabilities Parameters (<custom_parameters> Element)
E.3.5.2
Custom WMS Capabilities Service Attributes (<service_attributes> Element)
E.3.5.3
Custom WMS Layer Attributes (<layer_attributes> Element)
E.3.5.4
Custom WMS Feature Information (<get_feature_info> Element)
F
OGC WMTS Support in MapViewer
F.1
WMTS Service for MapViewer
F.2
WMTS Operations
F.2.1
GetCapabilities Operation Support
F.2.2
GetTile Operation Support
F.2.2.1
Map tiles in WMTS Layer and in Map Cache Tile Layer
F.2.3
GetFeatureInfo Operation Support
F.2.3.1
OGC GetFeatureInfo Request
F.2.3.2
MapViewer GetFeatureInfo Request at an (x,y) Point
F.2.3.3
MapViewer GetFeatureInfo Request within a Bounding Box
F.3
Preparing the WMTS Service for MapViewer
F.3.1
Prepare Predefined Geometry Themes
F.3.2
Prepare the Base Map
F.3.3
Prepare Tile Layers
F.3.4
Publish Tile Layers in the wmtsConfig.xml Policy File
F.3.5
Verify the MapViewer WMTS Service
Index
Scripting on this page enhances content navigation, but does not change the content in any way.