Interfejs Routes Preferred API udostępnia 3 preferencje routingu do obliczania tras. Różnią się one stopniem uwzględniania natężenia ruchu w obliczeniach trasy. Każde ustawienie trasy daje wyniki, które różnią się pod względem jakości trasy, przewidywanego czasu dojazdu i opóźnienia odpowiedzi.
Warunki na drodze
Warunki na drodze charakteryzują tempo przepływu ruchu. Na przykład:
Gdy nie ma korków, warunki na drodze są uznawane za normalne, a ruch odbywa się z normalną prędkością.
W okresie zbliżającego się szczytu natężenie ruchu wzrasta, co powoduje jego spowolnienie, a w efekcie łagodny lub umiarkowany ruch.
W przypadku korków natężenie ruchu spada do zera, co powoduje duże natężenie ruchu.
Nieświadomy ruch
Gdy ustawisz preferencję kierowania TRAFFIC_UNAWARE, trasy są obliczane bez uwzględniania warunków ruchu. Ta preferencja routingu zapewnia najkrótszy czas odpowiedzi (najszybsze zwracanie odpowiedzi).
Użyj tej opcji, gdy chcesz, aby odpowiedzi były zwracane najszybciej, a przybliżone informacje o trasie są wystarczające.
Z uwzględnieniem natężenia ruchu
Gdy ustawisz preferencję wyznaczania trasy TRAFFIC_AWARE, trasy są obliczane z uwzględnieniem warunków ruchu. Dzięki temu trasa i jej szczegóły lepiej odzwierciedlają rzeczywiste warunki. Zwiększenie jakości danych odbywa się kosztem opóźnienia odpowiedzi, dlatego stosujemy optymalizacje wydajności, aby zmniejszyć opóźnienie.
Użyj tej opcji, jeśli chcesz uzyskać dokładniejsze informacje o przekierowaniu, ale nie przeszkadza Ci, że odpowiedzi będą się pojawiać z niewielkim opóźnieniem.
Traffic aware optimal
Gdy ustawisz preferencję kierowania TRAFFIC_AWARE_OPTIMAL, trasy są obliczane z uwzględnieniem warunków ruchu, ale nie są stosowane żadne optymalizacje skuteczności. W tym trybie serwer wykonuje bardziej wyczerpujące wyszukiwanie sieci drogowej, aby znaleźć optymalną trasę.
Ta preferencja routingu zapewnia najdłuższy czas oczekiwania na odpowiedź (czyli najdłuższe opóźnienie w przypadku odpowiedzi). Użyj tej opcji, jeśli chcesz uzyskać wyniki o najwyższej jakości, niezależnie od czasu oczekiwania na odpowiedzi.
Przykład
Poniższy kod JSON pokazuje, jak ustawić preferencję kierowania w treści elementu zapytania.
{
"origin":{
"location":{
"latLng":{
"latitude":37.419734,
"longitude":-122.0827784
}
}
},
"destination":{
"location":{
"latLng":{
"latitude":37.417670,
"longitude":-122.079595
}
}
},
"travelMode":"DRIVE",
"routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}