TileJSON
- Last UpdatedFeb 27, 2025
- 1 minute read
Renders a layer specified in a TileJSON format. TileJSON is an open standard for representing map metadata supported by following servers:
-
Carto
-
Mapbox
-
Maptiler
-
TileStache
If you are using a third-party URL (mapbox, maptiler, …), ensure your usage is in compliance with the provider's terms of use.
An API key is required to use maptiler services. For more information about obtaining an API key, see the maptiler website- https://docs.maptiler.com/cloud/api
The following table provides the specific configurable options available for this layer:
|
Property |
Type |
Description |
|---|---|---|
|
crossOrigin [Optional] |
String |
Defines the crossOrigin attribute for loaded images. Set this to "anonymous" if CORS issue is encountered. For more information, refer https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image. |
|
tileSize [Optional] |
Number |
The tile size used by the tile service. |
|
type |
tilejson |
A type of Layer. |
|
url |
String |
Defines URL to the TileJSON file. |
Examples for TileJSON
Below is an example of a TileJSON layer URL provided by maptiler:
-
Configuration and map preview

-
JSON string configuration
{
"title": "Tilejson streets night",
"type": "tilejson",
"url": "https://api.maptiler.com/maps/streets-v-night/tiles.json?key={YOUR_KEY}",
"isBaseMap": true
}