Żądanie
{
"profile": "road-bike", "lengthKm": 86.458, "ascentM": 1083, "durationS": 20880,
"geometry": { "type": "LineString", "coordinates": [[lon, lat, ele], ...] }
}- points
- Od 2 do 50 punktów jako [lon, lat]: start, punkty pośrednie, meta
- profile
bike(domyślnie),city,road-bike,quiet-road-bike,gravel,mtb,hiking,car,shortest- alternative
- Od 0 do 3: najlepsza trasa lub jedna z trzech alternatyw
- format
geojson(domyślnie) lubgpx
Ile trwa wyznaczenie trasy
Routing przeszukuje sieć dróg, więc czas rośnie wraz z odległością. W naszych testach 13-kilometrowy przejazd po mieście trwał jedną lub dwie sekundy, 85 do 140 km sześć do dziesięciu sekund, a 530 km od 20 do 25 sekund. Wyszukiwanie, które trwałoby dłużej niż dwie minuty, kończy się statusem 504; dodaj punkt pośredni lub podziel podróż na etapy. Start w strefie dla pieszych albo na ścieżce, z której profil nie może korzystać, zwraca 404 z no_route.
Limity
Trasa liczy się raz za każde rozpoczęte 100 km znalezionej trasy (50 km dla profilu MTB), zarówno do żądań, jak i do tras, więc trasa 250 km liczy się jako trzy, a na MTB jako pięć. Trasy mają też własny limit tych, które mogą działać naraz.
| Plan | Tras dziennie | Tras naraz | Cena |
|---|---|---|---|
| Free | 20 | 1 | $0 |
| Developer | 1,000 | 2 | 14,99 USD miesięcznie |
| Pro | 5,000 | 2 | 39,99 USD miesięcznie |
Po wyznaczeniu trasy
Wyślij linię z powrotem, by dostać to, co leży wzdłuż niej: pogodę na godzinę dotarcia, profil wysokościowy, wodę, jedzenie i sklepy, wodowskazy rzek, stacje jakości powietrza, granice i strefy czasowe. POST /v1/route/report zwraca kilka z nich w jednym żądaniu.
Źródła: trasy na danych map © OpenStreetMap contributors, dostępnych na licencji Open Database License.