Une API de POI pour les lieux le long d'un itinéraire

La requête

POST /v1/route-poi/corridor prend l'itinéraire sous forme de points avec leur distance depuis le départ en mètres, comme un enregistreur de trace ou un planificateur d'itinéraire les a déjà, et les catégories voulues.

{
  "sections": [[
    { "lat": 46.204, "lon": 6.143, "d": 0 },
    ...
    { "lat": 45.924, "lon": 6.869, "d": 64484 }
  ]],
  "categories": ["water", "food", "bike"]
}

Itinéraire

Jusqu'à 1 000 km et 1 000 points par requête, en 64 sections au maximum

Catégories

water, food, grocery, toilets, bike, fuel, et sur demande sleep, sights, charging, bench, picnic

Distance à l'itinéraire

Par défaut, selon la catégorie : 150 m pour l’eau et les toilettes, 200 m pour la nourriture, les commerces, les magasins de vélo et les stations-service, jusqu’à 1 km pour l’hébergement et les sites à voir. maxDistanceM fixe une distance pour toutes les catégories et distancesM une par catégorie, jusqu’à 5 km. Avec 2 km de largeur, l’itinéraire peut aller jusqu’à 1 000 km ; avec 5 km, jusqu’à 400 km.

La réponse

{
  "routeLengthKm": 64.484,
  "totals": { "water": 40, "food": 117, "bike": 4, "grocery": 0, "fuel": 0, "toilets": 0 },
  "pois": [
    { "id": "node/1379366890", "category": "water", "subtype": "drinking_water", "name": null,
      "lat": 46.2047788, "lon": 6.1417476, "flags": { "hasWater": true },
      "tags": { "amenity": "fountain", "drinking_water": "yes" },
      "distanceAlongRouteKm": 0, "offsetFromRouteM": 130 },
    ...
  ],
  "gaps": []
}

Chaque arrêt garde ses tags OpenStreetMap : horaires d'ouverture, enseigne et moyens de paiement y figurent quand les contributeurs les ont ajoutés. Les magasins de chaînes et les stations-service peuvent s'afficher avec le logo de leur enseigne, servi par la même API. Une sortie de Genève à Chamonix, 64 km, a renvoyé 161 arrêts.

Pour une requête courte, ou vos propres tags

L'endpoint Overpass accepte around avec une ligne, pour n'importe quel tag, et les exemples montrent une union de toilettes et d'eau potable le long d'une sortie.

Qui l'utilise

Applications pour longues sorties, courses de bikepacking, ultra-trails et road trips, où le prochain point d'eau ou le dernier magasin avant l'étape de nuit comptent plus qu'une carte pleine d'épingles. La même clé donne la météo le long de l'itinéraire, son profil altimétrique et le routage.

Crédits : données cartographiques © contributeurs d'OpenStreetMap, disponibles sous l'Open Database License.