TileJSON Tileset Metadata (3.0.0)
Open BetaTileJSON ist eine kompakte offene JSON-Spezifikation von Mapbox, die einen Kachelsatz beschreibt: wo die Kacheln abzuholen sind (eine URL-Vorlage), in welchen geografischen Grenzen sie existieren, minimale und maximale Zoomstufe, Attribution und Ebenenbeschreibungen. Es sind nicht die Kacheln selbst, sondern ein maschinenlesbares Manifest, das MapLibre, Mapbox GL JS und OpenLayers automatisch erkennen und aus dem sie Grenzen, Zoom und Attribution selbst übernehmen. Auf osm2cdr.ru erzeugt der Export für das gewählte Gebiet eine einzelne JSON-Datei der Version 3.0.0: bounds stammen aus der bbox, center wird automatisch berechnet, und vector_layers listet die Ebenennamen auf. Die URL-Vorlage der Kacheln lässt sich über einen Parameter festlegen.
Hauptmerkmale
Über das Format TileJSON
TileJSON ist eine kleine JSON-Datei, die dem Client die Fragen beantwortet «woher nehme ich die Kacheln, in welchen Grenzen gibt es sie, auf welchen Zoomstufen und wen nenne ich in der Attribution». Die Spezifikation stammt von Mapbox, heute ist sie De-facto-Standard: MapLibre, Mapbox GL JS und OpenLayers verstehen ein solches Manifest ab Werk.
Der Sinn liegt in der Trennung: Die Kacheln liegen im Speicher und werden lange zwischengespeichert, das leichte Manifest wird separat ausgeliefert und aktualisiert, wenn sich Grenzen oder Zoomstufen ändern. Dem Client genügt ein Link auf das JSON — bounds, center, Zoombereich und Attribution setzt er selbst.
Der Export liefert eine Datei der Version 3.0.0: Die Grenzen stammen aus dem gewählten Gebiet, das Zentrum wird daraus berechnet, die Ebenennamen sind aufgeführt, das Adressschema ist xyz, und die URL-Vorlage der Kacheln wird über einen Parameter festgelegt. Die Kacheln selbst stecken nicht darin — die exportiert man separat als MVT, PMTiles oder Raster-XYZ-Kacheln.
Programme zum Öffnen von TileJSON-Dateien
Die folgenden Programme können TileJSON Tileset Metadata (3.0.0)-Dateien (.json) öffnen, bearbeiten und verarbeiten, die aus OSM2CDR exportiert wurden:
Format-Spezifikationen
- Offener Standard
- Nur 2D
- Verlustfrei
- Keine Attribute
- Ausgabe: 1 Datei
- 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.
Wer nutzt TileJSON-Karten
So exportieren Sie TileJSON
Nach dem Export öffnen
- MapLibre GL JS oder Mapbox GL JS — fügen Sie eine Quelle mit dem Feld url und dem Link auf dieses JSON hinzu; die Engine liest bounds, Zoomstufen und Attribution selbst.
- OpenLayers — die Quelle ol/source/TileJSON nimmt die Adresse der Datei entgegen und konfiguriert sich ohne zusätzlichen Code danach.
- Speicherort — legen Sie das JSON neben die Kacheln auf S3, R2, GitHub Pages oder Ihren eigenen Server; ausgeliefert werden muss es mit dem Typ application/json.
- Adresse anpassen — ersetzen Sie die Kachelvorlage durch den echten Pfad zu Ihrem Satz, sonst fordert der Client nicht existierende Kacheln an.
- Prüfen — öffnen Sie die Datei im Browser: Es ist gewöhnliches JSON, alle Felder sind mit dem Auge sichtbar, ein Fehler in der Adresse fällt sofort auf.
Beliebte Karten in TileJSON
TileJSON Tileset Metadata (3.0.0)-Kartenexport
Laden Sie professionelle TileJSON-Karten aus OpenStreetMap herunter. Sofortige Generierung, beliebiges Gebiet.