TileJSON Tileset Metadata (3.0.0)
Open BetaTileJSON es una especificación JSON abierta y compacta de Mapbox que describe un conjunto de teselas: de dónde obtenerlas (una plantilla de URL), dentro de qué límites geográficos existen, el zoom mínimo y máximo, la atribución y la descripción de las capas. No son las teselas en sí, sino un manifiesto legible por máquinas que MapLibre, Mapbox GL JS y OpenLayers reconocen automáticamente, configurando por su cuenta los límites, el zoom y la atribución. En osm2cdr.ru la exportación genera un único archivo JSON de la versión 3.0.0 para la zona elegida: bounds procede del bbox, center se calcula automáticamente y vector_layers enumera los nombres de las capas. La plantilla de URL de las teselas se ajusta con un parámetro.
Características principales
Acerca del formato TileJSON
TileJSON es un pequeño archivo JSON que responde al cliente a las preguntas «de dónde tomar las teselas, dentro de qué límites existen, en qué zooms y a quién citar en la atribución». La especificación la ideó Mapbox y hoy es un estándar de facto: MapLibre, Mapbox GL JS y OpenLayers entienden ese manifiesto de serie.
La gracia está en la separación: las teselas viven en el almacenamiento y se cachean durante mucho tiempo, mientras que el manifiesto, ligero, se sirve aparte y se actualiza cuando cambian los límites o los zooms. Al cliente le basta un único enlace al JSON: bounds, center, el rango de zooms y la atribución los establece por su cuenta.
La exportación entrega un único archivo de la versión 3.0.0: los límites se toman de la zona elegida, el centro se calcula a partir de ellos, se enumeran los nombres de las capas, el esquema de direcciones es xyz y la plantilla de URL de las teselas se define con un parámetro. Las teselas en sí no están dentro: se exportan aparte en MVT, PMTiles o teselas ráster XYZ.
Programas para abrir archivos TileJSON
Los siguientes programas y aplicaciones pueden abrir, editar y procesar archivos TileJSON Tileset Metadata (3.0.0) (.json) exportados desde OSM2CDR:
Format specifications
- Open standard
- 2D only
- Lossless (no quality loss)
- No attributes
- Output: 1 file
- 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én usa los mapas TileJSON
Cómo exportar a TileJSON
Cómo abrir tras la exportación
- MapLibre GL JS o Mapbox GL JS — añada una fuente con el campo url y el enlace a este JSON; el motor leerá por su cuenta los bounds, los zooms y la atribución.
- OpenLayers — la fuente ol/source/TileJSON acepta la dirección del archivo y se configura a partir de él sin código adicional.
- Almacenamiento — coloque el JSON junto a las teselas en S3, R2, GitHub Pages o en su propio servidor; hay que servirlo con el tipo application/json.
- Corrección de la dirección — sustituya la plantilla de teselas por la ruta real de su conjunto, o el cliente pedirá teselas inexistentes.
- Comprobación — abra el archivo en el navegador: es un JSON corriente, todos los campos se ven a simple vista y un error en la dirección se detecta de inmediato.
Mapas populares en TileJSON
Exportar mapas a TileJSON Tileset Metadata (3.0.0)
Descarga mapas TileJSON profesionales desde OpenStreetMap. Generación instantánea, cualquier área.