ES:Overpass turbo/GeoJSON

From OpenStreetMap Wiki
Jump to navigation Jump to search
Overpass API logo.svg
edit
API de Overpass · Referencia de lenguaje · Guía de lenguaje · Términos técnicos · Áreas · Ejemplos de consultas · Ejemplos avanzados · Edición dispersa · ID permanente · Preguntas frecuentes · más (español) · Sitio web
Estado de servidores · Versiones · Desarrollo · Diseño técnico · Instalación · Capa de compatibilidad XAPI · Esquemas de transporte público · Aplicaciones · Código fuente e incidencias
Overpass turbo · Asistente · Atajos de Overpass turbo · Hojas de estilo MapCSS · Exportar a GeoJSON · más (español) · Desarrollo · Código fuente e incidencias · Sitio web

GeoJson es un formato abierto para codificar un dato geográfico. A continuación se ofrece una descripción de la estructura del GeoJSON exportado por Overpass turbo.

Overpass turbo usa la biblioteca osmtogeojson para convertir a GeoJSON la salida de datos en bruto de OSM que obtiene de la API de Overpass.

Estructura

Todos los datos se dan como una colección de características o FeatureCollection. Los siguientes metadatos se dan en este nivel:

  • generator: el nombre de la aplicación que genera los datos (p. ej., "overpass-turbo")
  • copyright: la atribución de derechos de autor dada por la fuente de datos
  • timestamp: la marca de tiempo dada por la fuente de datos

Cada característica o Feature en la colección tiene el miembro properties que contiene los siguientes datos:

  • @id: un id que identifica al objeto, formado a partir de tipo de dato de OSM (nodo, vía, relación) y el id de OSM (p. ej., node/123, way/4321, etc.).
  • todas las etiquetas del objeto OSM[1]
  • meta-data (si está disponible) - codificado con un signo @ inicial (@timestamp, @version, @changeset, @user, @uid)
  • @tainted: si está presente, indica que la geometría de la característica está incompleta
  • @relations: una serie de relaciones de las que el objeto es miembro. Cada relación está codificada como un objeto literal que contiene las siguientes propiedades: role (rol de membresía), rel (el id de la relación) y reltags (que contiene todas las etiquetas de la relación).

La geometría es la estándar de GeoJSON.

Datos contenidos

El GeoJSON producido por Overpass turbo incluirá exactamente una característica GeoJSON por cada uno de los siguientes objetos OSM (que es todo lo que también está visible en la vista del mapa de Overpass turbo):

  • todas las vías[2]
  • todos los nodos etiquetados[3] o inconexos («PDI»)
  • todos los multipolígonos[4]

No contiene algunos datos que pueden ser devueltos por la API de Overpass (por ejemplo: áreas de Overpass, objetos sin coordenadas, vías-nodos, etc.) y las relaciones arbitrarias solo están presentes a través de sus hijos. Por tanto, no hay una relación 1:1 entre los datos de OSM y el GeoJSON exportado.

Salida de ejemplo

{
  "type": "FeatureCollection",
  "generator": "overpass-turbo",
  "copyright": "The data included in this document is from www.openstreetmap.org. The data is made available under ODbL.",
  "timestamp": "2013-04-25T08:50:03Z",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "@id": "way/181440866",
        "landuse": "meadow",
        "@timestamp": "2012-09-17T13:06:55Z",
        "@version": "1",
        "@changeset": "13143419",
        "@user": "tyr_asd",
        "@uid": "115612",
        "@relations": [
          {
            "role": "inner",
            "rel": "130768",
            "reltags": {
              "landuse": "forest",
              "type": "multipolygon"
            }
          }
        ]
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              11.2070535,
              46.4834059
            ],
            [
              11.2067411,
              46.483376
            ],
            [
              11.2066324,
              46.4830587
            ],
            /* -- snip -- */
            [
              11.2070535,
              46.4834059
            ]
          ]
        ]
      },
      "id": "way/181440866"
    },
    {
      "type": "Feature",
      "properties": {
        "@id": "way/119434107",
        "highway": "path",
        "ref": "500",
        "sac_scale": "mountain_hiking",
        "@timestamp": "2011-09-14T11:41:32Z",
        "@version": "2",
        "@changeset": "9298589",
        "@user": "tyr_asd",
        "@uid": "115612",
        "@tainted": true,
        "@relations": [
          {
            "role": "",
            "rel": "1537588",
            "reltags": {
              "network": "rwn",
              "operator": "Società degli Alpinisti Tridentini",
              "osmc:symbol": "red:red:white_bar:500:black",
              "ref": "500",
              "route": "hiking",
              "type": "route"
            }
          }
        ]
      },
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            11.2071162,
            46.4838528
          ],
          [
            11.2068518,
            46.4829
          ],
          [
            11.207187,
            46.481963
          ],
          [
            11.207199,
            46.481105
          ]
        ]
      },
      "id": "way/119434107"
    }
  ]
}

Notas

  1. las etiquetas que empiezan con un signo @ se ofrecerán con un signo @ adicional delante
  2. excepto aquellas que estén sin etiquetar y solo formen el contorno de un multipolígono
  3. las etiquetas «no interesantes», tales como «created_by» y «source» se ignoran en este caso
  4. los multipolígonos simples con exactamente una vía externa cerrada están presentes a través de su vía externa