Prerequisites
Before using custom map configurations, you’ll need:- A Mapbox API key with access to your custom tilesets
- Knowledge of your boundary configuration details:
- Source layer name
- Tileset ID
- Boundary format (column name for matching)
Setting Up Your Mapbox API Key
- Navigate to your team settings
- Locate the “Custom Map Boundaries Configuration” section
- Enter your Mapbox API key
- Save the configuration
Configuring Custom Boundaries
When creating or editing a choropleth map:- Select “Custom” as the boundary type
- Configure the following settings:
- Custom Boundary Source Layer: The name of your source layer (e.g., “custom-regions”)
- Custom Boundary Tileset: Your Mapbox tileset ID (e.g., “mapbox://your-tileset-id”)
- Custom Boundary Format: The column name in your tileset that contains the matching values (e.g., “postcode”)
Default Behavior
If any custom settings are left unspecified:- Source Layer: Defaults to the standard states layer
- Tileset: Uses the default Explo engineering tileset
- Boundary Format: Uses standard state format (STUSPS)
Troubleshooting
If your custom map configuration isn’t working:- Verify your Mapbox API key has access to the specified tileset
- Ensure the boundary format matches exactly with your data column names
- Check that your source layer name matches the one in your Mapbox tileset