Workbench Map Vendors

Note: The use of legacy workbench layouts is deprecated and is not supported. You should start using enhanced workbench layouts instead.

If you have multiple map vendors implemented, you can switch between them using the Map Vendor option in the Map Parameters section of an Enhanced Workbench Map. Map functionality may vary slightly depending on the map vendor selected.

Map vendor options are:

• HERE
• ALK
• MAPLIBRE, and
• Oracle Map Cloud Services

Note: To configure map vendors, see ALK Properties, HERE Properties, and eLocation Properties (Oracle Map Cloud Services and MAPLIBRE). Maps may also require changes to the ALK DEFAULT EDE ID, HERE DEFAULT EDE ID, ORACLE ELOCATION DEFAULT EDE ID (for Oracle Map Cloud Services and MAPLIBRE), and USE DEFAULT EDE PARAMETERS in the Logic Configuration for Workbench.

 

HERE

If the map vendor is HERE you see the following controls.

• Measure Distance: Select this option to display the Measure distance icon on the map. Click the icon on the map to calculate distances between geographical locations, which you select  by clicking on the map.
• Overview Map: Select this option to display the Minimap icon on the map. Click the icon on the map to view a small overview of the main map.
• Zoom to Area: Select this option to display the Zoom rectangle icon on the map. Click the icon on the map and select an area on the map to zoom to.

For location clustering with HERE maps, set the following parameters under Locations:

• Enable Clustering: By default clustering is enabled for HERE maps. Deselect the Enable Clustering checkbox to disable clustering. This is not available on the Workbench Location logic configuration page.
• Maximum Radius: Sets the maximum radius of the locations to be clustered. Default value will be 32. Enter a number between 2 and 256. This is not available on the Workbench Location logic configuration page.
• Minimum Points: Default value will be 2. Enter a number between 2 and 100. This is not available on the Workbench Location logic configuration page.

Tile Properties: This is a collapsible section that only appears on a HERE map. You only see this section if the property here.api_key is populated with the HERE V3.1 key and the property here.useLatestApiKey is set to true. Once enabled, you can set the first and second languages, congestion and environmental zones, vehicle restrictions, point of interest, etc. to appear on the HERE map. These options act as temporary overrides to the map parameters defined on the Logic Configuration - Workbench page.

ALK

If the map vendor is ALK you see the following controls. Select a control to display it on the map.

• Overview Map: Select this option to display the overview map icon on the map. Click the icon on the map to view a small overview of the main map.
• Navigation Toolbar: Select this option to display the navigation toolbar on the map. The Navigation toolbar contains four icons to aid in the navigation of the map. The first icon toggles panning of the map. The second icon zooms to the selected area on the screen. The third and fourth icons are history buttons that allow you to move through your navigation history of the map.
• Geolocation Toolbar: Select this option to display the geolocation toolbar on the map. The geolocation toolbar contains two icons related to the Geolocation API. The functionality of this control is dependent on both the browser supporting the Geolocation API and the user granting access to their location. The first icon uses the browser's Geolocation API to determine the current longitude and latitude based on the available information. The second icon locks the returned location as the "current" location.
• Mouse Coordinates: Select this option to display the longitude and latitude coordinate of the current location of the mouse pointer.

MapLibre

Note: If you are currently using the Oracle Map Cloud Services Map Vendor option in your Enhanced Workbenches, we recommend updating your Enhanced Workbenches to use the MapLibre Map Vendor option instead of the Oracle Map Cloud Services option.

While MapLibre is provided as a Map Vendor option, MapLibre is an open-source mapping library that can be used as an adapter and plotting tool.  With this introductory use of MapLibre, the MapLibre Map Vendor option within the Enhanced Workbench is being used as an adapter and plotting tool for the Oracle Spatial OMCS backend.  Using MapLibre as the adapter and plotting tool for Oracle Maps Cloud Service/Oracle Spatial provides you with some immediate improvements not available in the legacy Oracle Map Cloud Service Map Vendor option.

• Drag-and-drop functionality for shipments, shipment stops, and order releases objects
• Directional arrows for enhanced visual representation of shipment direction
• Clustering support for improved performance and cleaner map views of locations
• Compass integration as part of the map’s navigation tools, allowing for a reorientation of the map view
• Capture Map feature to save or export current map view

The MapLibre Map Vendor option does not require any additional configuration.

Controls

If the map vendor is MAPLIBRE, you should see the following controls:

Compass: The compass allows you, by holding the right mouse button,  to reorient the direction of the map - you can reset the map by selecting the compass icon.

Actions

Capture Map: feature to save or export a snapshot of the current map view.

 

Oracle Maps Cloud Services (OMCS)

If the map vendor is Oracle Map Cloud Services you see the following controls.

• Magnify Area: Select this option to display the magnify rectangle on the map. Move the rectangle to an area of the map to magnify it.
• Toolbar: Select this option to display a toolbar which contains the Clear, Distance, and Zoom icons. The Clear icon clears all the tools present on the map which were added using this toolbar. The Distance icon helps to calculate distances between geographical locations, which you select by clicking on the map. The Zoom icon zooms to the selected area on the map.