Add Map Backgrounds
You can add Google, Baidu, and other web map service backgrounds to use in visualizations.
Add Web Map Service (WMS) Backgrounds
You can add web map service backgrounds and use them in map visualizations.
Add Tiled Web Map (XYZ) Backgrounds
You can add tiled web map (XYZ) backgrounds and use them in map visualizations.
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}
Web Map Background Troubleshooting Tips
You might experience errors when you add a web map background. For example, a web map background image isn't displayed in the Preview tab or in a visualization.
Use these methods to find and diagnose web map background errors:
- Press F12 to display the
browser Developer Tools application and search for errors in
the browser console tab. For example, search for
error
orCORS
. Error messages are displayed in red text. - If you see an error message similar to
Access to image at http://example.com has been blocked by CORS policy...
, contact the host provider to resolve the issue. Error messages that refer to the Cross Origin Resource Sharing (CORS) policy can only be resolved by the host provider.