Overpass JSON es el formato de respuesta de la Overpass API, un lenguaje de consulta de solo lectura sobre OpenStreetMap (Roland Olbricht, desde 2008). Es un JSON compacto con una lista de elements (node/way/relation), su geometría, sus etiquetas y un bloque meta: la estructura que analizan directamente osmnx, el complemento QuickOSM de QGIS, overpass-turbo y decenas de flujos de trabajo que usan OSM como conjunto de datos estructurado. Nuestro exportador construye un JSON con esa misma estructura a partir de las capas de OSM: cada objeto se convierte en un element del tipo correspondiente con id, coordenadas, geometría y etiquetas, más una sección meta con generator y version. Con toda honestidad: sintetizamos una respuesta compatible con el formato Overpass a partir de su selección — no es una consulta en vivo a la Overpass API, pero el resultado puede entregarse a las herramientas posteriores como sustituto directo de una respuesta del Overpass público.
Características principales
Acerca del formato Overpass JSON
Overpass JSON es el formato de respuesta de la Overpass API, el lenguaje de consultas sobre los datos de OpenStreetMap. Es un JSON compacto: un array elements en el que cada objeto es un node, un way o una relation con sus coordenadas, su geometría y sus etiquetas, más un bloque de servicio meta. Esa estructura la leen directamente OSMnx, el complemento QuickOSM de QGIS, overpass-turbo y decenas de flujos de investigación.
Se recurre a este formato cuando OSM se usa como conjunto de datos estructurado: contar objetos por etiquetas, construir el grafo de calles, volcar puntos de interés a un script propio. Tener el archivo listo en vez de una consulta en vivo elimina dos problemas habituales de Overpass —los límites de frecuencia de peticiones y los tiempos de espera en selecciones grandes— y además hace el resultado reproducible: usted tiene en la mano una instantánea fija de los datos.
El exportador sintetiza una respuesta con esa misma estructura a partir de su selección: los puntos pasan a ser elementos node con coordenadas, y las líneas y los polígonos, elementos way con su lista de nodos y su geometría; las etiquetas se trasladan tal cual y en meta se escriben el generador y la versión. Los identificadores se asignan por nuestra cuenta, desde un rango aparte, para no cruzarse con los números reales de OSM; el volumen de un archivo está limitado a cien mil elementos. No es una consulta en vivo a Overpass, sino un sustituto compatible de su respuesta.
Programas para abrir archivos Overpass JSON
Los siguientes programas y aplicaciones pueden abrir, editar y procesar archivos Overpass API JSON (.json) exportados desde OSM2CDR:
Format specifications
- Open standard
- 2D only
- Lossless (no quality loss)
- Stores feature attributes
- Output: 1 file
- An Overpass-API-compatible JSON (elements node/way/relation + meta) synthesized from the selection; a drop-in replacement for a public Overpass response, not a live query.
Quién usa los mapas Overpass JSON
Cómo exportar a Overpass JSON
Cómo abrir tras la exportación
- Python — json.load() y trabajo con la lista elements: filtrar por etiquetas, contar objetos, volcar a una tabla. La biblioteca overpy acepta los mismos datos.
- jq — comprobación rápida en la terminal: jq '.elements | length' map.json muestra cuántos objetos han llegado, y jq '.elements[0]', qué aspecto tiene un elemento.
- osmtogeojson — conversión a GeoJSON con un solo comando, si más adelante le resulta más cómodo trabajar en un SIG o en la web.
- QGIS con el complemento QuickOSM — cargar la respuesta guardada y obtener las capas en el mapa sin consultar el Overpass público.
- Sus propios analizadores y flujos de trabajo, que ya saben leer la salida de Overpass — ponga el archivo en lugar de la URL, el formato es el mismo.
Mapas populares en Overpass JSON
Exportar mapas a Overpass API JSON
Descarga mapas Overpass JSON profesionales desde OpenStreetMap. Generación instantánea, cualquier área.