Map

The 2D map shows platform positions, sensor footprints, tracks, and other available geographic information. Use 3D View to inspect the same playback metadata on a globe.

Choosing a base map

Open Layers in the upper-right corner of the map and select a configured base layer.

Base map selection

Centering the map

Choose how the map follows the playback metadata:

  • Platform: center on the platform position.
  • Frame: center on the video frame center.
  • Target: center on the reported target, when available.
  • Manual: navigate without automatic centering.

Map centering controls

Configuring base maps

Administrators can edit the maps.layers section in data/config.json. Each layer has a title, tile URL template, and attribution. The following is a configuration fragment:

"maps": {
    "layers": [
      {
        "title": "OpenStreetMap",
        "tileLayer": "https://a.tile.openstreetmap.org/{z}/{x}/{y}.png",
        "attribution": "&copy; <a href=\"http://osm.org/copyright\">OpenStreetMap</a>"
      },
      {
        "title": "OpenTopoMap",
        "tileLayer": "https://{s}.tile.opentopomap.org/{z}/{x}/{y}.png",
        "attribution": "Map data: &copy; <a href=\"http://www.openstreetmap.org/copyright\">OpenStreetMap</a>, <a href=\"http://viewfinderpanoramas.org\">SRTM</a> | Map style: &copy; <a href=\"https://opentopomap.org\">OpenTopoMap</a> (<a href=\"https://creativecommons.org/licenses/by-sa/3.0/\">CC-BY-SA</a>)"
      },
      {
        "title": "Esri_WorldStreetMap",
        "tileLayer": "https://server.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer/tile/{z}/{y}/{x}",
        "attribution": "Tiles &copy; Esri &mdash; Source: Esri, DeLorme, NAVTEQ, USGS, Intermap, iPC, NRCAN, Esri Japan, METI, Esri China (Hong Kong), Esri (Thailand), TomTom, 2012"
      },
      {
        "title": "Esri_WorldTopoMap",
        "tileLayer": "https://server.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer/tile/{z}/{y}/{x}",
        "attribution": "Tiles &copy; Esri &mdash; Esri, DeLorme, NAVTEQ, TomTom, Intermap, iPC, USGS, FAO, NPS, NRCAN, GeoBase, Kadaster NL, Ordnance Survey, Esri Japan, METI, Esri China (Hong Kong), and the GIS User Community"
      },
      {
        "title": "Esri WorldImagery",
        "tileLayer": "https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}",
        "attribution": "Tiles &copy; Esri &mdash; Source: Esri, i-cubed, USDA, USGS, AEX, GeoEye, Getmapping, Aerogrid, IGN, IGP, UPR-EGP, and the GIS User Community"
      },
      {
          "title": "Google",
          "tileLayer": "https://www.google.cn/maps/vt?lyrs=s@189&gl=cn&x={x}&y={y}&z={z}",
          "attribution": "Google"
      },
      {
          "title": "Offline maps",
          "tileLayer": "http://localhost:5000/{z}/{x}/{y}.png",
          "attribution": "Offline Tiles"
      }
    ]
  }

Offline maps

Prepare tiles for the required areas and zoom levels, then serve them from a local HTTP server. Configure a layer with the tile server's URL, for example:

http://localhost:5000/{z}/{x}/{y}.png

Here, z is the zoom level and x and y are the tile coordinates. The browser loads the tiles, so localhost refers to the viewing computer. Use a reachable server address when clients run on other computers. Select the offline layer explicitly; configuring it does not create an automatic fallback from online providers.

For a TMS tile service, use {-y} instead of {y}, for example:

http://tiles.example.local/tms/1.0.0/tileset/{z}/{x}/{-y}.png

XYZ numbering starts at the top of the map; TMS numbering starts at the bottom.

Preparing tiles

If you use Mobile Atlas Creator, select the area and zoom levels and export an OSMdroid ZIP atlas. Extract the tiles and serve the directory that contains the zoom-level folders. Match the configured URL to the extracted directory structure.

Mobile Atlas Creator

You can serve tiles with Nginx or another static HTTP server. Preserve the dataset's attribution. For local 3D terrain and imagery configuration, see 3D View.