TileJSON est une spécification JSON ouverte et compacte, créée par Mapbox, qui décrit un jeu de tuiles : où récupérer les tuiles (un modèle d'URL), dans quelles limites géographiques elles existent, les zooms minimal et maximal, l'attribution et la description des couches. Ce ne sont pas les tuiles elles-mêmes, mais un manifeste lisible par la machine, que MapLibre, Mapbox GL JS et OpenLayers reconnaissent automatiquement en réglant seuls les limites, le zoom et l'attribution. Sur osm2cdr.ru, l'export produit un unique fichier JSON en version 3.0.0 pour la zone choisie : les limites proviennent du bbox, le centre est calculé automatiquement, et vector_layers énumère les noms des couches. Le modèle d'URL des tuiles se règle par un paramètre.
Caractéristiques principales
À propos du format TileJSON
TileJSON est un petit fichier JSON qui répond au client aux questions « où prendre les tuiles, dans quelles limites elles existent, à quels zooms et qui citer dans l'attribution ». La spécification a été imaginée par Mapbox ; c'est aujourd'hui un standard de fait : MapLibre, Mapbox GL JS et OpenLayers comprennent ce manifeste d'emblée.
Tout l'intérêt tient à la séparation : les tuiles restent sur l'hébergement et sont mises en cache pour longtemps, tandis que le manifeste, léger, est servi à part et se met à jour quand les limites ou les zooms changent. Un seul lien vers le JSON suffit au client — il réglera lui-même les bounds, le center, la plage de zooms et l'attribution.
L'export livre un fichier unique en version 3.0.0 : les limites proviennent de la zone choisie, le centre en est déduit, les noms des couches sont énumérés, le schéma d'adressage est xyz, et le modèle d'URL des tuiles se règle par un paramètre. Les tuiles elles-mêmes n'y sont pas — elles s'exportent séparément en MVT, PMTiles ou tuiles raster XYZ.
Logiciels pour ouvrir les fichiers TileJSON
Les programmes suivants peuvent ouvrir, modifier et traiter les fichiers TileJSON Tileset Metadata (3.0.0) (.json) exportés depuis OSM2CDR :
Caractéristiques du format
- Standard ouvert
- 2D uniquement
- Sans perte de qualité
- Sans attributs
- Sortie : 1 fichier
- A single TileJSON 3.0.0 manifest (bounds, center, min/maxzoom, vector_layers, configurable {z}/{x}/{y} URL); a descriptor of a tileset, not the tiles themselves.
Qui utilise les cartes TileJSON
Comment exporter en TileJSON
Comment ouvrir après l’export
- MapLibre GL JS ou Mapbox GL JS — ajoutez une source dont le champ url pointe vers ce JSON ; le moteur lira lui-même les bounds, les zooms et l'attribution.
- OpenLayers — la source ol/source/TileJSON accepte l'adresse du fichier et se configure d'après lui, sans code supplémentaire.
- Hébergement — placez le JSON à côté des tuiles sur S3, R2, GitHub Pages ou votre propre serveur ; il doit être servi avec le type application/json.
- Correction de l'adresse — remplacez le modèle d'URL des tuiles par le chemin réel de votre jeu, sinon le client demandera des tuiles inexistantes.
- Vérification — ouvrez le fichier dans un navigateur : c'est du JSON ordinaire, tous les champs se lisent à l'œil et une erreur d'adresse se repère aussitôt.
Cartes populaires en TileJSON
Export de cartes en TileJSON Tileset Metadata (3.0.0)
Téléchargez des cartes TileJSON professionnelles depuis OpenStreetMap. Génération instantanée, n’importe quelle zone.