Skip to main content

Maps

Introduction to Maps

A map creates a visual representation of a single data set, i.e., a table or a view. You can use the settings for overlays and data mapping to configure maps to suit your needs with, for example, routes, defined areas, weather information or traffic information.

Adding a map

menu User Interface > Maps > tab Maps

or

menu User interface > Subjects > Components > tab Maps

  1. Select a table or variant.
  2. Add a Project and Project version.
  3. Select the Table or view to which you want to add a map.
note

The table or view needs a screen type with a Maps component to show the map in your end-product.

  1. Define Linked columns to populate the map with entities:

    • Data mapping column: contains an image combo control with elements.
      The element images are the markers on the map. You must define at least one element. More elements are useful if you have different types of data within the entity, such as a route with a starting point and a destination.
      For every element, you can further specify the settings on the Data mappings tab.
    • Lat/long column: contains the Location coordinates for the entity.
    • Popup column: contains HTML data or plain text that will be displayed when hovering over the entity on the map.
  2. Specify the Initial settings:

    • Enter the Latitude and Longitude to initially center the map on a location.
    • Set the Zoom level (number, check with your provider about the scale used).

Maps Maps settings

  1. Set more specifications in the tabs:

Location coordinates

The location coordinates with longitude and latitude must be specified in JSON format as follows:

 { "CoordSets": [ [ { "Lon": "5.9795099", "Lat": "52.2084904" } ] ] }

To display a line (used for routes) or polygon (used for areas), the JSON must contain multiple coordinates:

 { "CoordSets": [ [ { "Lon": "-76.499107", "Lat": "39.243073" }, { "Lon": "-76.499146", "Lat": "39.243053" } ] ] }

The coordinates are not automatically retrieved, so make sure you have a process to call a Geolocation web service. For example, Google, Here, OpenMaps, or Mapquest.

Base layer settings

The base layer is the layer shown in the maps component.

menu User Interface > Maps > tab Base layers

or

menu User interface > Subjects > Components > tab Base layers

  1. Enter a Base layer URI to retrieve the layer information.

    • You can use external providers such as Google, Here maps, Open maps, Mapquest, or your own favourite map provider.
    • You can only configure tile layers using x,y,z URLs. A tile layer is a set of tiles that reside on a server and are accessed by a direct URL request from the browser.

    This is an example of the Google Maps URI:

    https://mt0.google.com/vt/lyrs=m&hl=en&x={x}&y={y}&z={z}
    • lyrs=m - the standard Google roadmap
    • lyrs=s - the Google satellite view
    • lyrs=h - the hybrid view.
  2. Enter settings like minimum and maximum zoom levels.

  3. If necessary, use the Attribution field to store the attribution HTML snippet.

Base layer Base layer settings for maps

Overlay settings

An overlay can be shown on top of the base layer to add extra information, such as weather or traffic information.

menu User Interface > Maps > tab Tables > tab Default/Variants > tab Overlays

or

menu User interface > Subjects > Components > tab Overlays

  1. Enter an Overlay URI.
  2. Enter settings like minimum and maximum zoom levels and the overlay's opacity.
  3. Select the Show overlay box to make the overlay available. Use this, for example, for variants.
  4. Select the Show in menu box to make the overlay available to your users for selection in the map's legend.
  5. If necessary, use the Attribution field to store the attribution HTML snippet.

Overlay Overlay settings for maps

Example 2 An example of an overlay in a map

Data mappings

The overview displays all the domain elements of the data mapping column.

menu User Interface > Maps > tab Data mappings

or

menu User interface > Subjects > Components > tab Data mappings

  1. Specify the Geometric type of the data mapping.
  2. If the Geometric type is a Marker, you can use an image as a custom marker. This column requires a domain with an image combo control.
  3. If the Geometric type is not a Marker, you can specify additional settings, like border and fill color.
  4. To display record data on the map, select the Show data mapping checkbox.

Data mapping Data mapping settings for maps

Example 1 An example of data mapping: route planner