Eine POI-API für Orte entlang einer Route

Die Anfrage

POST /v1/route-poi/corridor nimmt die Route als Punkte mit ihrer Entfernung vom Start in Metern entgegen, so wie sie ein Track-Recorder oder ein Routenplaner schon hat, und dazu die gewünschten Kategorien.

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

Route

Bis zu 1.000 km und 1.000 Punkte pro Anfrage, in bis zu 64 Abschnitten

Kategorien

water, food, grocery, toilets, bike, fuel und auf Anfrage sleep, sights, charging, bench, picnic

Abstand zur Route

Standardmäßig je Kategorie: 150 m für Wasser und Toiletten, 200 m für Essen, Läden, Fahrradläden und Tankstellen, bis 1 km für Unterkünfte und Sehenswürdigkeiten. maxDistanceM setzt einen Abstand für alle Kategorien, distancesM einen je Kategorie, bis 5 km. Bei 2 km Breite darf die Route bis 1.000 km lang sein, bei 5 km bis 400 km.

Die Antwort

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

Jeder Halt behält seine OpenStreetMap-Tags, sodass Öffnungszeiten, Marke und Zahlungsangaben vorhanden sind, wenn Mapper sie ergänzt haben. Filialen von Ketten und Tankstellen können mit ihren Markenlogos angezeigt werden, die über dieselbe API ausgeliefert werden. Eine Fahrt von Genf nach Chamonix, 64 km, kam mit 161 Halten zurück.

Für eine kurze Abfrage oder eigene Tags

Der Overpass-Endpoint nimmt around mit einer Linie entgegen, für jedes Tag, das Sie brauchen, und die Beispiele zeigen eine Vereinigung aus Toiletten und Trinkwasser entlang einer Fahrt.

Wer sie nutzt

Apps für lange Touren, Bikepacking-Rennen, Ultraläufe und Roadtrips, bei denen das nächste Wasser oder der letzte Laden vor einer Nachtetappe mehr zählt als eine Karte voller Pins. Derselbe Key liefert das Wetter entlang der Route, ihr Höhenprofil und das Routing.

Quellenangabe: Kartendaten © OpenStreetMap contributors, verfügbar unter der Open Database License.