API POI dla miejsc wzdłuż trasy

Żądanie

POST /v1/route-poi/corridor przyjmuje trasę jako punkty z ich odległością od startu w metrach, tak jak już mają ją rejestratory śladów i planery tras, oraz wybrane kategorie.

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

Trasa

Do 1000 km i 1000 punktów na żądanie, w maksymalnie 64 odcinkach

Kategorie

water, food, grocery, toilets, bike, fuel, a na życzenie sleep, sights, charging, bench, picnic

Odległość od trasy

Domyślnie dla każdej kategorii osobno: 150 m dla wody i toalet, 200 m dla jedzenia, sklepów, serwisów rowerowych i stacji paliw, do 1 km dla noclegów i atrakcji. maxDistanceM ustawia jedną odległość dla wszystkich kategorii, a distancesM osobną dla każdej, do 5 km. Przy pasie 2 km trasa może mieć do 1000 km, przy 5 km do 400 km.

Odpowiedź

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

Każdy przystanek zachowuje swoje tagi OpenStreetMap, więc godziny otwarcia, marka i informacje o płatnościach są dostępne, jeśli dodali je mapujący. Sklepy sieciowe i stacje paliw można pokazać z logo marek, serwowanymi z tego samego API. Przejazd z Genewy do Chamonix, 64 km, zwrócił 161 przystanków.

Dla krótkiego zapytania lub własnych tagów

Endpoint Overpass przyjmuje around z linią, dla dowolnego potrzebnego tagu, a przykłady pokazują sumę toalet i wody pitnej wzdłuż przejazdu.

Kto z tego korzysta

Aplikacje do długich przejazdów, wyścigów bikepackingowych, ultramaratonów i podróży samochodem, w których następna woda albo ostatni sklep przed etapem nocnym znaczy więcej niż mapa pełna pinezek. Ten sam klucz daje pogodę wzdłuż trasy, jej profil wysokościowy i routing.

Źródła: dane map © OpenStreetMap contributors, dostępne na licencji Open Database License.