Add Tiled Web Map (XYZ) Backgrounds

You can add tiled web map (XYZ) backgrounds and use them in map visualizations.

Tiled web map (XYZ) backgrounds are displayed in a browser by seamlessly joining dozens of individually requested image or vector data files over the Internet through a web server. You can use them to integrate maps containing information that you might not have in your enterprise, and easily present them spatially with your data.

You configure tile URL strings to specify vector tiles or raster tiled map images to load. The host evaluates each string and determines which tile to load.

Contact your tiled web map service provider to find out the correct URLs. Parameters in the URLs tell the hosting server what to display in the map background. For example, the map name, version, and the number of tiles to use at the specified focus. Here are some examples of Mapbox tiled web map background URLs:

  • https://api.mapbox.com/styles/v1/mapbox/streets-v11/tiles/256/{z}/{x}/{y}
  • https://api.mapbox.com/styles/v1/mapbox/satellite-v9/tiles/256/{z}/{x}/{y}
  • https://api.mapbox.com/styles/v1/mapbox/light-v10/tiles/256/{z}/{x}/{y}
  • https://api.mapbox.com/styles/v1/mapbox/dark-v10/tiles/256/{z}/{x}/{y}
  • https://api.mapbox.com/styles/v1/mapbox/outdoors-v11/tiles/256/{z}/{x}/{y}
  1. On your home page, click Navigator Navigator icon used to display the Navigator, and click Console.
  2. In the Console, select Maps, click Backgrounds, and then click Map Backgrounds.
  3. Click Add Background and select Tiled Web Map from the list.
  4. Click the General tab and enter a name and description.
  5. In URL, enter the full URL for the host tiled web map service.
  6. Click the plus (+) icon to enter additional server URLs in the same domain, for load balancing.
  7. Click I agree to trust this external host to automatically add the host to your list of safe domains.
  8. Display the Parameters tab and click Add Parameter.

    Parameters that you enter are included in the URL and tell the hosting server what to display in the map background (for example, image type, layer, geographic extent of the map, size of the returned image).

    For example, you might enter access_token with a value of exampleaccessTokenXyZ123456789nnnxxxZZz.

    Contact your provider for details.

  9. Enter parameters that you want to pass in the URL to the host server in key:value format.
  10. Click Save to add the specified tiled web maps to the list of available map backgrounds.

    You must refresh a page to see any changes.

  11. Click Preview to display a preview of the map background.

    The Preview tab only becomes available after the page is saved and refreshed . This is because the refresh enables recognition of the safe domains.