Konfigurowanie porównania jakości i czasu oczekiwania

Interfejs Routes Preferred API udostępnia 3 ustawienia routingu do obliczania tras. Różnią się one stopniem uwzględniania warunków drogowych w obliczeniach trasy. Każda preferencja routingu daje wyniki, które w pewnym stopniu różnią się pod względem jakości trasy, szacowanego czasu przybycia i opóźnienia odpowiedzi.

Informacje o warunkach na drogach

Warunki na drodze określają natężenie ruchu. Na przykład:

  • Gdy nie ma korków, warunki na drodze są uznawane za normalne, a ruch odbywa się z normalną, niezakłóconą prędkością.

  • Zbliża się godzina szczytu, więc natężenie ruchu wzrasta, co powoduje spowolnienie ruchu i w konsekwencji lekkie lub umiarkowane natężenie ruchu.

  • W korku natężenie ruchu spada do zera, co powoduje duże utrudnienia.

Bez informacji o ruchu

Gdy ustawisz preferencje dotyczące routingu TRAFFIC_UNAWARE, trasy są obliczane bez uwzględniania warunków drogowych. Ta preferencja routingu zapewnia najmniejsze opóźnienie odpowiedzi (odpowiedzi są zwracane najszybciej).

Użyj tego ustawienia routingu, gdy chcesz jak najszybciej otrzymywać odpowiedzi, a przybliżone szczegóły routingu są wystarczające.

Uwzględnianie natężenia ruchu

Gdy ustawisz preferencje dotyczące trasy TRAFFIC_AWARE, trasy są obliczane z uwzględnieniem warunków drogowych. Dzięki temu trasa i jej szczegóły dokładniej odzwierciedlają rzeczywiste warunki. Ponieważ wzrost jakości danych odbywa się kosztem opóźnienia odpowiedzi, stosujemy optymalizacje wydajności, aby znacznie zmniejszyć to opóźnienie.

Używaj tego ustawienia routingu, gdy zależy Ci na dokładniejszych szczegółach routingu, ale nie przeszkadza Ci umiarkowany wzrost opóźnienia w odpowiedziach.

Optymalne z uwzględnieniem natężenia ruchu

Gdy ustawisz preferencje routingu TRAFFIC_AWARE_OPTIMAL, trasy są obliczane z uwzględnieniem warunków ruchu, ale nie są stosowane żadne optymalizacje wydajności. W tym trybie serwer przeprowadza dokładniejsze wyszukiwanie w sieci dróg, aby znaleźć optymalną trasę.

Ta preferencja routingu zapewnia największe opóźnienie odpowiedzi (tzn. odpowiedzi są zwracane z najdłuższym opóźnieniem). Użyj tego ustawienia routingu, jeśli chcesz uzyskać wyniki najwyższej jakości bez względu na czas odpowiedzi.

Przykład

Poniższy kod JSON pokazuje, jak ustawić preferencje routingu w treś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"
}