GET /decoupages/:id

A propos

Cette requête liste les informations d'un découpage et notamment ses zones.

Un découpage est un regroupement de plusieurs zones sur un thème particulier (ZAE, QPV, etc).
Toutes les zones appartiennent à un découpage.

URL

https://api.solutions-territoire.fr/v0/decoupages/:id

Informations

Disponibilité 0.6.0
Authentification requise Authorization Code ou Client Credentials
Scope requis Aucun
Formats disponibles JSON & GeoJSON
Code HTTP attendu 200

Réponse

JSON

découpage Object Un découpage avec toutes ses propriétés étendues.

GeoJSON

La réponse est une collection de features au format GeoJSON.
Chaque feature correspond à une zone du découpage, avec ses propriétés de base.

Exemples

Les exemples ci-dessous utilises la variable $ACCESS_TOKEN décrite dans la section Exemple : authentification en ligne de commande.

Exemple de requête JSON

cURL :

curl -X GET \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://api.solutions-territoire.fr/v0/decoupages/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11

HTTPie :

http -jv GET https://api.solutions-territoire.fr/v0/decoupages/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11 \
  Accept:"application/json" \
  Authorization:"Bearer $ACCESS_TOKEN"

Résultat :

GET /v0/decoupages/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11 HTTP/1.1
Accept: application/json
Authorization: Bearer dGCMv3RWEcgWjgeKS5D6IUw0gv2VKmaPqJzZg9mM_3A

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "decoupage":  {
    "id":        "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
    "title":     "Zones d'activités économiques",
    "url":       "/v0/decoupages/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
    "zones": [
      {
        "id":    "b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24",
        "title": "Zone des moulins",
        "url":   "/v0/zones/b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24"
      }
    ]
  }
}

Exemple de requête affichant les zones du découpages au format GeoJSON

cURL :

curl -X GET \
  -H "Accept: application/geo+json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://api.solutions-territoire.fr/v0/decoupages/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11

HTTPie :

http -jv GET https://api.solutions-territoire.fr/v0/decoupages/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11 \
  Accept:"application/geo+json" \
  Authorization:"Bearer $ACCESS_TOKEN"

Résultat :

GET /v0/decoupages/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11 HTTP/1.1
Accept: application/geo+json
Authorization: Bearer dGCMv3RWEcgWjgeKS5D6IUw0gv2VKmaPqJzZg9mM_3A

HTTP/1.1 200 OK
Content-Type: application/geo+json; charset=utf-8

{
  "type":     "FeatureCollection",
  "features": [
    {
      "type":     "Feature",
      "geometry": {
        "type":        "Polygon",
        "coordinates": [
          [
            [ 2.2056555747985844, 48.702021761507254 ],
            [ 2.1997332572937016, 48.700619750456592 ],
            [ 2.2061920166015639, 48.698821153845664 ],
            [ 2.2066426277160653, 48.701101253604171 ],
            [ 2.2056555747985844, 48.702021761507254 ]
          ]
        ]
      },
      "properties": {
        "id":    "b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24",
        "title": "Zone des moulins",
        "url":   "/v0/zones/b3e2ea99-10ca-2eca-a26e-6ae91c0ab0c24"
      }
    },
    { ... },
    { ... }
  ]
}