Table of Contents

• List of Examples
• List of Figures
• List of Tables
• Title and Copyright Information
• Preface
  • Audience
  • Related Documentation
  • Acknowledgments
  • Conventions
• 1 Introduction to the Map Visualization Component 23.2
  • 1.1 Overview of the Map Visualization Component
    • 1.1.1 Map Visualization Component Architecture
  • 1.2 Getting Started with the Map Visualization Component
  • 1.3 Prerequisite Software for the Map Visualization Component
  • 1.4 Deploying MapViewer-Based Applications with the Map Visualization Component
  • 1.5 Administering the Map Visualization Component
    • 1.5.1 Logging in to the Map Visualization Component Administration Page
    • 1.5.2 Configuring the Map Visualization Component
      • 1.5.2.1 Specifying Logging Information
      • 1.5.2.2 Specifying Map File Storage and Life Cycle Information
      • 1.5.2.3 Specifying a Web Proxy
      • 1.5.2.4 Specifying Global Map Configuration Options
      • 1.5.2.5 Customizing the Spatial Data Cache
      • 1.5.2.6 Specifying the Security Configuration
      • 1.5.2.7 Registering a Custom Spatial Provider
      • 1.5.2.8 Registering Custom Nonspatial Data Providers
      • 1.5.2.9 Customizing SRS Mapping
      • 1.5.2.10 Customizing WMS GetCapabilities Responses
      • 1.5.2.11 Customizing WMTS GetCapabilities Responses
      • 1.5.2.12 Configuring the Map Tile Server for Oracle Maps
      • 1.5.2.13 Defining Permanent Map Data Sources
        • 1.5.2.13.1 Data Sources
          • 1.5.2.13.1.1 Catalog Data Sources
      • 1.5.2.14 Configuring and Securing the Map Data Server for the HTML5 API
    • 1.5.3 Creating a Map Visualization Component Data Source Using a JDBC Container
      • 1.5.3.1 Create a JDBC Data Source in a Map Visualization Component Container
      • 1.5.3.2 Create a Map Visualization Component Data Source
    • 1.5.4 Creating a Map Visualization Component Data Source Using Oracle Service Name
    • 1.5.5 Performing Map Visualization Component Administrative Tasks
  • 1.6 High Availability and the Map Visualization Component (WebLogic Server Only)
    • 1.6.1 Deploying the Map Visualization Component on a Middle-Tier Cluster
  • 1.7 Secure Map Rendering
    • 1.7.1 How Secure Map Rendering Works
    • 1.7.2 Getting the User Name from a Cookie
    • 1.7.3 Options for Authenticating Users
• 2 Map Visualization Concepts
  • 2.1 Overview of the Map Visualization Component
  • 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.2.6 Allowing a Text Style to Overlap or Be Overlapped
  • 2.3 Themes
    • 2.3.1 Predefined Themes
      • 2.3.1.1 Styling Rules in Predefined Spatial Geometry Themes
      • 2.3.1.2 How the Map Visualization Component 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.1.8 Primary and Secondary Labels for Linear Features
    • 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.4.4 Virtual Mosaic Themes
    • 2.3.5 Network Themes
      • 2.3.5.1 Creating Predefined Network Themes
      • 2.3.5.2 Using the Map Visualization Component 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 How a Map Is Generated
  • 2.6 Cross-Schema Map Requests
  • 2.7 Workspace Manager Support in the Map Visualization Component
  • 2.8 Map Visualization Component Metadata Views
    • 2.8.1 xxx_SDO_STYLES Views
    • 2.8.2 xxx_SDO_THEMES Views
    • 2.8.3 xxx_SDO_MAPS Views
    • 2.8.4 xxx_SDO_CACHED_MAPS Views
  • 2.9 Oracle Maps
    • 2.9.1 Overview of Oracle Maps
    • 2.9.2 Architecture for Oracle Maps Applications
• 3 Map Visualization 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.1.1 map_request Attributes
      • 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 Map Visualization Component 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.2.1 Store the tiles using the local file system
        • 3.3.1.2.2 Store the tiles in a database table
        • 3.3.1.2.3 Stream the tiles directly without storing them
      • 3.3.1.3 Coordinate System for Map Tiles
      • 3.3.1.4 Tile Mesh Codes
      • 3.3.1.5 Map Tile Requests
      • 3.3.1.6 Tiling Rules
      • 3.3.1.7 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 map visualization component 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
  • 3.4 Vector Tile Server
• 4 Oracle Maps
  • 4.1 Oracle Maps JavaScript API
    • 4.1.1 About the Oracle Maps JavaScript API
  • 4.2 Developing Oracle Maps Applications
    • 4.2.1 Creating the Client Application with the API
  • 4.3 Using Google Maps
    • 4.3.1 Defining Google Maps Tile Layers on the Client Side
    • 4.3.2 Defining the Built-In Map Tile Layers on the Server Side
  • 4.4 Transforming Data to a Spherical Mercator Coordinate System
    • 4.4.1 Creating a Transformation Rule to Skip Datum Conversion
  • 4.5 Using Dynamic Tile Layers
    • 4.5.1 Creating a Universe and Configuration Instance for a Dynamic Tile Layer
    • 4.5.2 Creating a Dynamic Tile Layer Using a Base Map
    • 4.5.3 Creating a Dynamic Tile Layer Using Predefined Themes
    • 4.5.4 Creating a Dynamic Tile Layer Using Spatial Tables Directly
    • 4.5.5 Creating a Dynamic Tile Layer Using Third Party Map Services
    • 4.5.6 Dynamic Tile Layer Use Case
• 5 Oracle Map Builder Tool
  • 5.1 Running Oracle Map Builder
    • 5.1.1 Java Libraries for Theme Creation with GDAL and Teradata
  • 5.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 Pre-Defined 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 Spatial Data Provider
  • C.1 Implementing the Spatial Provider Class
  • C.2 Registering the Spatial Provider with the Map Visualization Component
  • C.3 Rendering the External Spatial Data
• D Creating and Registering a Custom Image Renderer
• E OGC WMS Support in the Map Visualization Component
  • E.1 Setting Up the WMS Interface for the Map Visualization Component
    • E.1.1 Preparing the Data Sources and Editing the wmsConfig.xml File
    • E.1.2 Data Source Named wms
    • E.1.3 SDO to EPSG SRID Mapping File
  • E.2 WMS Specification and Corresponding Map Visualization Component Concepts
    • E.2.1 Supported GetMap Request Parameters
      • E.2.1.1 BASEMAP Parameter (Map Visualization Component-Only)
      • E.2.1.2 BBOX Parameter
      • E.2.1.3 BGCOLOR Parameter
      • E.2.1.4 DATASOURCE Parameter (Map Visualization Component-Only)
      • E.2.1.5 DYNAMIC_STYLES Parameter (Map Visualization Component-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 (Map Visualization Component-Only)
      • E.2.1.11 MVTHEMES Parameter (Map Visualization Component-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 (Map Visualization Component-Only)
      • E.2.3.7 RADIUS Parameter (Map Visualization Component-Only)
      • E.2.3.8 UNIT Parameter (Map Visualization Component-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 Customizing GetCapabilities Responses: Additional Options
      • E.3.4.1 Custom WMS Capabilities Parameters (<custom_parameters> Element)
      • E.3.4.2 Custom WMS Capabilities Service Attributes (<service_attributes> Element)
      • E.3.4.3 Custom WMS Layer Attributes (<layer_attributes> Element)
      • E.3.4.4 Custom WMS Feature Information (<get_feature_info> Element)
• F OGC WMTS Support in the Map Visualization Component
  • 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
    • F.3.6 Tips for Creating a WMTS Compliant Custom Tile Layer
• Index