Mapbox Tiling Service
Beta

Warnings

Public beta

Mapbox Tiling Service is in public beta. All features and workflows are subject to potential changes.

Even a successful Mapbox Tiling Service (MTS) job may have some warnings, indicating that some features in your tileset source(s) were dropped in the resulting tileset. Each warning contains information about how to make sure the feature is not dropped in your next job.

Types of warnings

CodeDescriptionExample
W201One or more features were dropped due to tile size limits.W201: Features were dropped from mountains layer in 2 tile(s) to enforce tile size limits. Affected zoom levels are: 0,2
W202One or more features were dropped due to decoding errors.W202: LineString must contain at least 2 points - Example: {"id":5,"type":"Feature","properties":{},"geometry":{"type":"LineString","coordinates":[]}}
W203One or more features were dropped due to encoding errors.W203: Invalid number of points in polygon ring, can not encode - Example: {"id":18,"type":"Feature","properties":{},"geometry":{"type":"Polygon","coordinates":[[[100.0,0.0],[101.0,0.0]]]}}
W204One or more features were dropped due to duplicate ids; make sure every feature in your tileset source has a unique id to avoid this warning.W204: Feature(s) were dropped from restaurants layer because of duplicate feature ids. Affected feature ids include: 724305,4196773

Note: W202 and W203 errors are capped to 20 per job, and may not include all the decoding/encoding errors in your source data.

Troubleshooting

Tile Size Limits

MTS Tilesets are capped at 500 KB per layer. If a layer exceeds that size, the Mapbox Tiling Service will drop features and emit a W201 warning. Every W201 warning contains the layer and zoom level(s) where the features were dropped. Recommendations for how to avoid this warning vary according to your data and use case; for more information, read our documentation on what to do if you see gaps of missing data in your tiles.

Once you have made the recommended changes, you will need to re-publish the tileset to see the feature(s) in the updated tileset.

GeoJSON Encoding

If there are incorrectly formatted GeoJSON features in your tileset source, the Mapbox Tiling Service will drop the feature and emit a W202 or W203 warning. Every W202 or W203 warning contains an example of the dropped feature, to help you identify the formatting bug.

Because tileset sources can be large, W202 and W203 errors are capped to 20 per job, and may not include all the decoding/encoding errors in your source data. To track down all the GeoJSON errors in your dataset, we recommend using the tilesets CLI to validate your tileset source(s). Once you have identified and fixed the issue, you will need to re-upload your source data and re-publish the tileset to see the feature(s) in the updated tileset.

Was this page helpful?