Konfigurowanie porównania jakości i czasu oczekiwania

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

Informacje o warunkach na drogach

Warunki na drogach charakteryzują natężenie ruchu. Na przykład:

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

• W miarę zbliżania się godzin szczytu gęstość ruchu wzrasta, co powoduje spowolnienie ruchu i lekkie lub umiarkowane warunki na drogach.

• W przypadku korków ruch zwalnia do zera, co powoduje duże natężenie ruchu.

Bez uwzględniania warunków na drogach

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

Użyj tej preferencji routingu, gdy chcesz, aby odpowiedzi były zwracane jak najszybciej, a przybliżone szczegóły routingu są wystarczające.

Z uwzględnianiem warunków na drogach

Gdy ustawisz preferencję routingu TRAFFIC_AWARE, trasy są obliczane z uwzględnieniem warunków na drogach. Dzięki temu trasa i jej szczegóły dokładniej odzwierciedlają rzeczywiste warunki. Ponieważ wzrost jakości danych wiąże się z opóźnieniem odpowiedzi, stosowane są optymalizacje wydajności, aby zmniejszyć opóźnienie.

Użyj tej preferencji routingu, gdy chcesz uzyskać dokładniejsze szczegóły routingu, ale nie przeszkadza Ci, że odpowiedzi są zwracane z umiarkowanym opóźnieniem.

Z uwzględnianiem warunków na drogach i optymalizacją

Gdy ustawisz preferencję routingu TRAFFIC_AWARE_OPTIMAL, trasy są obliczane z uwzględnieniem warunków na drogach, ale nie są stosowane żadne optymalizacje wydajności. W tym trybie serwer przeprowadza bardziej wyczerpujące wyszukiwanie w sieci dróg, aby znaleźć optymalną trasę.

Ta preferencja routingu zapewnia największe opóźnienie odpowiedzi (odpowiedzi są zwracane z największym opóźnieniem). Użyj tej preferencji routingu, gdy chcesz uzyskać wyniki najwyższej jakości, bez względu na to, jak długo trwa odpowiedź.

Przykład

Poniższy kod JSON pokazuje, jak ustawić preferencję 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"
}