Interfejs Routes Preferred API udostępnia 3 ustawienia routingu do obliczania tras. Różnią się one pod względem tego, w jakim stopniu uwzględniają warunki na drodze podczas obliczania trasy. Każde ustawienie trasy daje wyniki, które różnią się pod względem jakości trasy, szacowanego czasu dotarcia na miejsce i opóźnienia odpowiedzi.
Informacje o warunkach na drodze
Warunki na drodze określają natężenie ruchu. Na przykład:
Gdy nie ma korków, warunki na drodze są uważane za normalne, a ruch odbywa się ze zwykłą, niezakłóconą prędkością.
W godzinach szczytu natężenie ruchu wzrasta, co powoduje spowolnienie ruchu i prowadzi do lekkich lub umiarkowanych warunków na drodze.
W przypadku korka przepływ ruchu spada do zera, co powoduje trudne warunki na drodze.
Brak informacji o ruchu drogowym
Gdy ustawisz ustawienie trasy TRAFFIC_UNAWARE, trasy będą obliczane bez uwzględniania warunków na drodze. To ustawienie routingu zapewnia najniższy czas oczekiwania na odpowiedź (odpowiedzi są zwracane najszybciej).
Użyj tego ustawienia, gdy chcesz uzyskać odpowiedzi jak najszybciej, a przybliżone szczegóły trasy są wystarczające.
Uwzględnianie ruchu
Gdy ustawisz ustawienie trasy TRAFFIC_AWARE, trasy będą obliczane z uwzględnieniem warunków na drodze. Dzięki temu trasa i jej szczegóły dokładniej odzwierciedlają rzeczywiste warunki. Wzrost jakości danych odbywa się kosztem opóźnienia odpowiedzi, dlatego stosujemy optymalizacje wydajności, aby znacznie zmniejszyć opóźnienie.
Użyj tej opcji wyznaczania trasy, jeśli chcesz uzyskać dokładniejsze informacje o trasie i nie przeszkadza Ci, że odpowiedzi będą zwracane z umiarkowanie zwiększonym opóźnieniem.
Optymalna trasa z uwzględnieniem natężenia ruchu
Gdy ustawisz opcję trasy TRAFFIC_AWARE_OPTIMAL, trasy będą obliczane z uwzględnieniem warunków na drodze, ale nie będą stosowane żadne optymalizacje wydajności. W tym trybie serwer przeprowadza bardziej wyczerpujące wyszukiwanie w sieci dróg, aby znaleźć optymalną trasę.
To ustawienie routingu zapewnia najwyższy czas oczekiwania na odpowiedź (czyli odpowiedzi są zwracane z najdłuższym opóźnieniem). Użyj tej opcji routingu, gdy chcesz uzyskać wyniki najwyższej jakości, niezależnie od tego, jak długo potrwa odpowiedź.
Przykład
Poniższy kod JSON pokazuje, jak ustawić preferencje routingu w treści encji wiadomości żądania.
{ "origin":{ "location":{ "latLng":{ "latitude":37.419734, "longitude":-122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude":37.417670, "longitude":-122.079595 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE_OPTIMAL" }