Mapbox provides a number of handy, pre-built URLs and code snippets to help you add your custom Mapbox maps to other mapping tools. This tutorial will show you how you can add any Mapbox map as a layer in ArcMap or QGIS as WMTS.
Before diving in, make sure you have the following ready to go:
- A Mapbox account. If you haven’t done so already, sign up for a Mapbox account.
- ArcMap or QGIS installed on your computer. You should be somewhat familiar with your mapping software’s interface before starting this tutorial.
- A Mapbox style. Head to your style page in Mapbox studio to see a list of the styles in your account.
Add Mapbox maps in ArcMap
Both ArcMap and QGIS can read map tiles protocol, which is what you’ll use to add your Mapbox styles. To get started in ArcMap:
- Click the Add Data button in the toolbar to open the Add Data dialog box.
At the top of the dialog box, click the arrow next to Look in: and select GIS Servers.
Double-click Add WMTS Server to open the Add WMTS Server dialog box.
- Head to the share page for the Mapbox style you would like to add to ArcMap, then scroll to the bottom of the page and copy the WMTS endpoint: URL to your clipboard.
- In the URL field at the top, add the URL you copied in the previous step.
In the Server Layers section, click Get Layers. When prompted for a username and password, click Cancel. You may have to click it several times to dismiss the box.
When the layers are loaded in the window, click OK.
You should see Mapbox on api.mapbox.com in the Add Data dialog box. Double click it, select the name of your style in the next dialog box, then click Add.
You should see your map as a layer inside your ArcMap document. Note that each style will have to be added individually.
Add Mapbox maps in QGIS
Similarly, QGIS can read map tiles from a WMTS server. To add your Mapbox map to QGIS:
In QGIS, click the Add WMS/WMTS button.
- Make sure the Layers tab is selected in the dialog box. Below the dropdown menu at the top of the box, click New.
- Head to the share page for the Mapbox style you would like to add to ArcMap, then scroll to the bottom of the page, click the QGIS toggle, and copy the WMTS endpoint: URL to your clipboard.
Give the layer a name and add the URL you copied in the previous step. Press OK.
Back in the Add Layer(s) from a WM(T)S Server dialog box, the name of your layer should appear in the box at the top. When you see this, click Connect.
The Tilesets tab should open with a single layer. Select that layer and click Add, then click Close to close the dialog box.
You should see your map as a layer inside your QGIS document. Note that any style you would like to visualize will have to be added individually.
Congratulations! You used WMTS to add a Mapbox style to ArcMap and QGIS.