About Supported Maps

10.4.1 About Supported Maps

The map component consists of a background map and spatial geometry objects sourced from data in a table or from a REST Data Source.

About the Background Map

The background map is static and comes from Oracle Elocation Service. These background maps are ready to use and do not require any API keys. However, in order to display the background map, the end user's browser must have an internet connection and access to https://maps.oracle.com.

About Spatial Geometry Objects

Spatial geometry objects are drawn on the background map based on data in a table. That table can be sourced from local table or a SQL query. Maps created using the Create Page Wizard or in Page Designer, support both local database tables, REST Enabled SQL, and from REST Data Sources. Maps support a rich set of built-in marker icons and shapes. Supported spatial geometry objects include:

Points - Points (for example, customer or supplier locations) display as markers.
Lines - Lines represent features like roads or paths.
Polygons - Polygons represent areas like parcels, states or countries.
Heat Map - Heat Maps are used to visualize the point density. The more points that are clustered together, the more intense the color becomes. Use this option to visualize the spatial distribution of population or incidents.
Extruded Polygons - Display as three-dimensional, extruded, objects. The height of the 3D object visualizes a column value.

You can source spatial geometry objects from either:

Geometry Column - Supported datatypes include SDO_GEOMETRY, VARCHAR2, or CLOB. VARCHAR2 and CLOB columns must contain geometry information in GeoJSON format.
Two Numeric Columns - These columns must contain longitude and latitude values. This option only applies to Point and Heat Map objects.

About Map Controls

From a user's perspective, map regions include a number of controls that enable users to change the display at runtime.

Description of the illustration map_controls.png

The previous map include the following controls:

Navigation Bar - Options include Zoom, Zoom Out and Reset Bearing to North.
Rectangle Zoom - Zoom the map to an area by drawing a rectangle onto the map.
Circle Tool - Enables end users to draw a circle onto the map. When finished, an event is triggered, so that the circle can be processed by Dynamic Actions or JavaScript code.
Distance Tool - Zooms the map to an area by drawing a rectangle onto the map.
Tooltip - Displays a scale bar on the map.
Overview Map - Displays a scale bar on the map.
Scale Bar - Displays a scale bar on the map.
Legend - Displays an overview map in the lower right.

Not all of these controls are enabled by default. You can add or remove controls by editing the map region Attributes in Page Designer.