FR:Overpass turbo/GeoJSON

From OpenStreetMap Wiki
Jump to navigation Jump to search
Overpass API logo.svg
edit
API Overpass · Référence du langage · Guide du langage · Termes techniques · Aires · Exemples de requêtes · Édition clairsemée · ID persistant · Questions fréquentes · plus (français) · Site web
État des serveurs · Versions · Développement · Conception technique · Installation · Surcouche de compatibilité XAPI · Diagrammes de transports publics · Applications · Code source et problèmes
Overpass turbo · Assistant · Raccourcis Overpass turbo · Feuilles de style MapCSS · Export en GeoJSON · plus (français) · Développement · Code source et problèmes · Site web
Overpass Ultra · Overpass Ultra extensions · Feuilles de style MapLibre ·plus (français) · Code source et problèmes · Site web

GeoJSON est un format ouvert pour coder une donnée géographique. Voici une description de la structure du GeoJSON exporté par overpass turbo.

Structure

Toute la donnée est fournie en tant que FeatureCollection. Les métadonnées suivantes sont fournies à ce niveau:

  • generator: le nom de l'application générant la donnée (i.e. "overpass-turbo")
  • copyright: l'attribution de copyright telle que fournie par la données source
  • timestamp: l'horodatage tel que fourni par la donnée source

Chaque Feature dans la collection a les properties(propriétés) de membre contenant les propriétés suivantes:

  • @id: une id identifiant l'objet, formée d'après le type de données OSM (nœud, chemin, relation) et l'id OSM (ex: node/123, way/4321, …).
  • tous les tags de l'objet OSM [1]
  • métadonnées (si disponible) - encodées avec un @ au début (@timestamp, @version, @changeset, @user, @uid)
  • @tainted: si présent: indique que la géométrie de l'élément est incomplète.
  • @relations: un réseau de relations dont l'objet est membre. Chaque relation est encodée en tant qu'un objet littéral contenant les propriétés suivantes: role (role de membre), rel (l'id de la relation) et reltags (contient tous les tags de la relation).

La géométrie est GeoJSON standard.

Données contenues

Le GeoJSON produit par overpass turbo inclura précisément un élément GeoJSON pour chacun des objets OSM suivants (ceci est tout ce qui est également visible dans la vue de la carte dans overpass turbo):

  • tous les chemins[2]
  • tous les tagués[3] ou les nœuds non connectés ("POIs")
  • tous les multipolygones[4]

Il ne contient pas certaines données qui peut être renvoyée par l'API Overpass (par exemple: zones Overpass, objets sans coordonnées, chemin-noeuds, etc.) et les relations arbitraires sont uniquement présentes via leurs enfants. Donc, il n' ya pas de relation 1:1 entre les données OSM et le GeoJSON exporté.

Exemple de "sortie"

{
  "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"
    }
  ]
}

Références

  1. les tags commençant avec un signe @ seront "échappés" (non pris en compte ?) par un signe @ additionnel devant
  2. excepté ceux qui ne sont pas tagués et qui seulement forment le contour d'un multipolygone
  3. tags "inintéressants" comme "créé par" et dont les sources sont ignorées pour cela
  4. simples multipolygones avec exactement un chemin externe fermé qui sont présents via leur chemin externe