Response body message | HTTP status code | Description |
|---|---|---|
Not Authorized - Invalid Token | 401 | Check the access token you used in the query. |
Forbidden | 403 | There may be an issue with your account. Check your Account page for more details. In some cases, using an access tokens with URL restrictions can also result in a 403 error. For more information, see our Token management guide. |
Style not found | 404 | Check the style ID used in the query. |
Classic styles are no longer supported | 410 | Classic styles are no longer supported. See this Classic Styles blog post for additional deprecation details. |
Style may not composite raster sources with vector sources | 400 | The style the request uses contains a source reference that incorrectly composites sources of two different types. |
Invalid style source | 422 | The sources key within the style your request references contains an invalid value. |
Zoom level must be between 0-22. | 422 | The zoom level specified in the query is larger than 22 or contains non-numeric characters. |
Pitch must be between 0-60. | 422 | The pitch specified in the query is larger than 60 or contains non-numeric characters. |
{Width}/{Height} must be between 1-1280. | 422 | The width or the height specified in the query is larger than 1280 or contains non-numeric characters. |
Auto extent cannot be used with style parameters and no overlay | 422 | /auto/ is used for the extent in a request with style parameters that does not include an overlay. You should instead specify a longitude, latitude, and zoom for the request. |
Auto extent cannot be determined when GeoJSON has no features | 422 | /auto/ is used for the extent in a request with a GeoJSON overlay that has no features. For example, geojson({"type":"FeatureCollection","features":[]}). You should instead specify a longitude, latitude, and zoom for the request. |
The auto parameter cannot be used with additional location parameters, bearing, or pitch. | 422 | Additional location parameters (lon, lat, zoom), bearing, and pitch cannot be used with the auto parameter. |
The bounding box parameter cannot be used with additional location parameters, bearing, or pitch. | 422 | Additional location parameters (lon, lat, zoom), bearing, and pitch cannot be used with the bbox parameter. |
The GeoJSON argument has an unknown or unsupported geometry type | 422 | The GeoJSON geometry type in the overlay is not a supported geometry type. |
You can only use {addlayer}/{setfilter} once per request | 422 | Only one style parameter can be used in a single request. |
addlayer and setfilter cannot be used in the same request | 422 | Only one style parameter can be used in a single request. If you want to apply a filter to a new style layer, you should add a filter to the style layer object in the addlayer request. |
The new layer's source reference key does not match any source keys in the requested style. Specify url and type in the source for the new layer. | 422 | The source specified in the addlayer request does not match the requested style. You should reformat the new layer source so that it's an object with a type and url (for example source: { url: 'mapbox://mapbox.mapbox-streets-v8', type: 'vector'}). |
The new layer source url must be a properly formatted mapbox:// url (for example mapbox://mapbox.mapbox-streets-v7) | 422 | The new layer's source URL is not formatted correctly. |
Layer is missing required attributes (id, type, source) | 422 | The layer is missing an id, type, or source value. The new layer should follow Mapbox style layer syntax. |
New layer sources must contain a source type and url | 422 | The new layer source is missing the source type or url. |
New layers must be added with unique ids | 422 | The newly added layer has the same name as an existing layer in the style. You should rename the layer id to something else. |
New layer type must be one of the following types: background, fill, line, symbol, circle, fill-extrusion, heatmap, hillshade, raster | 422 | The new layer type must be a valid Mapbox GL JS layer type |
Must include layer_id in setfilter request | 422 | setfilter must be used with layer_id to know what layer to apply the filter to. |
layer_id must be an existing layer in the requested style | 422 | You can only apply the setfilter parameter to an existing layer in the style. |
Invalid filter syntax | 422 | The expression passed to setfilter is not a valid expression. |
Invalid layer passed to addlayer. Unable to parse JSON. | 422 | The JSON passed to addlayer is invalid. |
Padding must be 1-4 numbers, comma-delimited. | 422 | Padding must be 1-4 numbers (no units, since pixels are implied) that are comma-delimited, resembling the CSS specification for padding, like padding=5 or padding=5,8,10,7. |
The padding cannot exceed the height or width of the requested image. | 422 | The sum of the top and bottom padding cannot exceed the image height, and the sum of the left and right padding cannot exceed the image width. |
Padding cannot be used without the auto parameter or without a provided bounding box. | 422 | Padding can only be used with the auto parameter or with location specified by a bbox. Without the auto parameter or the bbox parameter, requests expect lon, lat, and zoom, and these values would change if asking for padding with a fixed image size. |
Invalid bbox: * | 422 | The provided bbox is invalid. Make sure the bbox contains 4 valid coordinates enclosed in square brackets and are ordered like [lon(min),lat(min),lon(max),lat(max)]. |
Overlay bounds are out of range. | 422 | The overlay coordinates are out of map range. Make sure the overlay coordinates are within range, meaning longitude between -180 and 180 and latitude between -85.0511 and 85.0511. |
Height and width must not exceed 1024px | 422 | The width and height of an image used as a custom marker overlay must be smaller than 1,024 pixels. |