You are going to learn about the TileJSON format and its benefits. This article will give you an overview of the most common use cases for TileJSON, show you the general description and specifications, and point you to various examples of its implementations in the MapTIler product ecosystem.
Using TileJSON for map tiles
What is a JSON?
What is a TileJSON?
It stores information such as where to request the tileset, the name of the tileset, the attribution necessary for using the tileset. It is also universally regarded as an open standard for representing map metadata. The description of the latest version is available on GitHub. MapTiler strongly recommends using the TileJSON format instead of the XYZ URL format.
How does MapTiler support the TileJSON in the Products?
TileJSON is widely implemented in the MapTiler product ecosystem. MapTIler Cloud and MapTiler Server have available endpoints for TileJSON for raster and vector tilesets. TileJSONs are used as main source tilesets for StyleJSONs and styling maps. Check out the documentation for TileJSON here.
Coordinate systems and TileJSON
TileJSON itself is designed only to use tiles in WebMercator projection EPSG:3857. However, standard WMTS allows using tiles in other projections. The MapTIler team filled this hole in the TileJSON and created specifications for the usage of different “SRS”. It requires adding the projection “CRS” or “proj4” field and the “tile_matrix”. These new keys follow the WMTS standard. MapTIler Cloud supports this TileJSON specification for all projections. For more information, see the full documentation on GitHub.
What is a MetadataJSON?
MetadataJSON is a metadata dataset description very similar to TileJSON, only without the mandatory address for the tiles. This file format is created every time when MapTiler Engine renders a folder structure for your maps. You can check further info about MetadataJSON in the documentation.
The TileJSON is a widely used format for storing and transmitting attributes of online (tiled) maps. Due to its broad acceptance and support, it offers probably the best usability and functionality available today….
GitHub - TileJSON specification
GitHub - MapTiler TileJSON specification
ViaEuropa - TileJSON specification
Mapbox - TileJSON metadata
Tiled Web Map
OpenLayers - TileJSON
MapTiler API - TileJSON Documentation
Wikipedia - JSON