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, gęstość ruchu wzrasta, co powoduje spowolnienie ruchu i powstanie warunków od lekkiego do umiarkowanego natężenia ruchu.

  • W korku o dużym natężeniu ruchu przepływ danych jest bardzo powolny, co powoduje duże natężenie ruchu.

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 najniższe 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. Ten wzrost jakości danych odbywa się kosztem opóźnienia odpowiedzi, dlatego 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 najdłuższy czas oczekiwania na odpowiedź (tzn. odpowiedzi są zwracane z największym 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"
}