About Map Portlets

You can use map portlets to present geographical-based data over a map layer.


Example of a border map showing New England population by county,

Optionally, users can zoom in and out, select or hide layers, and drag the map to see the geographic region of interest.

The Edit Map Portlet dialog box has an option to Lock map to position. If this option is selected, the Zoom in and Zoom out icons do not display on the map portlet.

Map view options.

DivePort can display data as boundary maps, point maps, heat maps, hexbin maps, line maps, or a combination of these map types. Optionally, you can use a web map service.

  • Boundary maps use country, province, state, county, or postal code data. Predefined regions of the map are color-coded according to the data summarized over a region.
  • Point maps use longitude and latitude coordinates to show data points. Summarized data concentration is shown using color or sizing of the data points.
  • Heat maps use longitude and latitude coordinates to show data concentration using colors.
  • Hexbin maps use longitude and latitude coordinates to show data concentration using colored hexagons.
  • Line maps use longitude and latitude coordinates to show origin-destination data by drawing lines on a map.

NOTE: Column data that contains longitude and latitude coordinates must be formatted as <longitude> <latitude> and the dimension name must be longlat. For example:

Longlat column.

Placing the pointer on a map opens a Closedtooltip that shows details about the specific location and data value.

In DivePort 7.1(19) and later, point maps can be set to refresh data at a specified interval, resulting in a real-time view.

Tooltip showing details about data for Boston.

Map Portlet Base Layer

The map portlet base layer is the map itself. You can select one of the following sources for your base layer:

ClosedOpen Street Map (OSM)

Example of an Open Street Map.

ClosedThunderforest: Outdoors

Example of an Outdoors map.

ClosedThunderforest: Transport

Example of a transport map layer.

ClosedThunderforest: Open Cycle Map

Example of an open cycle map layer.

ClosedThunderforest: Neighbourhood

Example of a neighborhood map layer.

ClosedThunderforest: Mobile Atlas

Example of a mobile atlas map layer.

ClosedStamen: Toner

Example of a toner map layer.

ClosedStamen: Toner Lite

Example of a toner lite map layer.

In addition, you can create your own custom GeoJSON file using a browser-based tool such as geojson.io. Each polygon in your custom geoJSON file must have a property that serves as a unique identifier for that polygon and the DivePort source data for the map must have a column that contains the polygon identifiers. Save your custom GeoJSON files in the \webdata\<diveport>\customizations\map-data folder to ensure that it appears as a Closedgeometry source in the edit map portlet wizard.

Edit map portlet, select a geometry source dialog box.

NOTE: The use of Thunderforest base layers requires a Thunderforest API key. For more information, go to:


During an upgrade, in order for DivePort to be able to replace the map_data.dat file in the webdata directory, which is a local cache of map data downloaded from DiveLine, Tomcat must have permission to delete that file.