Ustawianie poziomu danych o ruchu

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wybrane przez Ciebie ustawienia ruchu równoważą dokładność szczegółów trasy z wydajnością żądania na 2 sposoby:

  • Uwzględnianie natężenia ruchu – zwracanie jak najdokładniejszych wyników (większe opóźnienie).

  • Traffic unaware (Bez informacji o ruchu) – zwraca wyniki tak szybko, jak to możliwe (najmniejsze opóźnienie).

Gdy wysyłasz prośbę, zastanów się, czy lepiej jest zwrócić jak najdokładniejsze wyniki, czy jak najszybciej. Interfejs Routes API udostępnia opcje, które pozwalają kontrolować jakość danych odpowiedzi w porównaniu z opóźnieniem odpowiedzi.

Jak ustawić poziom ruchu

Interfejs Routes API udostępnia RoutingPreference (REST) i RoutingPreference (gRPC), które umożliwiają określanie preferencji dotyczących obliczania tras.

Domyślnie wyświetlane są wyniki bez uwzględniania ruchu. Opcje ruchu wybierasz w ustawieniach routingu TRAFFIC_UNAWARE, TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Każda preferencja routingu daje wyniki, które różnią się jakością trasy, szacowanym czasem dotarcia i opóźnieniem odpowiedzi.

warunkach na drogach,

Warunki na drogach określają natężenie ruchu:

  • Normalny ruch: brak korków, ruch odbywa się z normalną prędkością.

  • Mały lub średni ruch: rosnące natężenie ruchu, który płynie ze zmniejszoną prędkością.

  • Duży ruch: duże natężenie ruchu, znacznie zmniejszona prędkość.

Bez informacji o ruchu

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

TRAFFIC_UNAWARE są obliczane bez uwzględniania aktualnych warunków drogowych. Ta preferencja routingu zapewnia najszybszą odpowiedź na żądanie (najmniejsze opóźnienie).

Jeśli wybierzesz TRAFFIC_UNAWARE, trasa i czas podróży będą oparte na sieci dróg i średnich warunkach ruchu niezależnych od czasu, a nie na bieżących warunkach na drodze. W związku z tym trasy mogą obejmować drogi, które są tymczasowo zamknięte. Wyniki dla danego żądania mogą się zmieniać z czasem ze względu na zmiany w sieci dróg, zaktualizowane średnie warunki ruchu i rozproszony charakter usługi. Wyniki mogą się też różnić w przypadku niemal identycznych tras w dowolnym momencie i z dowolną częstotliwością.

Oto odpowiedzi, które zobaczysz:

  • duration – zawiera szacowany czas dotarcia na trasie.

  • staticDuration: szacowany czas dotarcia na trasie z uwzględnieniem tylko historycznych informacji o ruchu. W przypadku parametru TRAFFIC_UNAWARE zawiera on tę samą wartość co parametr duration.

Uwzględnianie natężenia ruchu

Użyj tej preferencji routingu, jeśli chcesz uzyskać dokładniejsze szczegóły routingu niż w przypadku TRAFFIC_UNAWARE, ale nie przeszkadza Ci umiarkowany wzrost opóźnienia w odpowiedziach.

Gdy ustawisz preferencje dotyczące TRAFFIC_AWARE, usługa obliczy trasę z uwzględnieniem aktualnych warunków drogowych. Dzięki temu trasa i jej szczegóły będą dokładniej odzwierciedlać rzeczywiste warunki. Ten wzrost jakości danych odbywa się kosztem czasu oczekiwania na odpowiedź, dlatego stosujemy optymalizacje wydajności, aby znacznie skrócić czas oczekiwania.

Oto odpowiedzi, które zobaczysz:

  • duration: szacowany czas dotarcia z uwzględnieniem informacji o natężeniu ruchu w czasie rzeczywistym.

  • staticDuration Szacowany czas dotarcia na miejsce na podstawie tylko historycznych informacji o ruchu drogowym.

Optymalizacja z uwzględnieniem natężenia ruchu

Użyj tego ustawienia routingu, jeśli chcesz uzyskać wyniki najwyższej jakości bez względu na czas odpowiedzi. Ten rodzaj routingu ma najdłuższe opóźnienie w zwracaniu odpowiedzi (największe opóźnienie).

Gdy ustawisz preferencje dotyczące TRAFFIC_AWARE_OPTIMALwyznaczania trasy, usługa obliczy trasę z uwzględnieniem aktualnych warunków na drodze, ale nie zastosuje optymalizacji wydajności. W tym trybie serwer przeprowadza bardziej wyczerpujące wyszukiwanie w sieci dróg, aby znaleźć optymalną trasę.

TRAFFIC_AWARE_OPTIMAL Preferencje dotyczące wyznaczania tras są równoważne trybowi używanemu przez maps.google.com i aplikację mobilną Mapy Google.

Jeśli używasz tej opcji z interfejsem Compute Route Matrix, liczba elementów w żądaniu (liczba punktów początkowych × liczba punktów docelowych) nie może przekraczać

  1. Więcej informacji o limitach macierzy wyznaczania tras znajdziesz w artykule Obliczanie macierzy tras.

Oto odpowiedzi, które zobaczysz:

  • duration: szacowany czas dotarcia na miejsce na podstawie informacji o ruchu w czasie rzeczywistym.

  • staticDuration: szacowany czas dotarcia na trasie z uwzględnieniem tylko historycznych informacji o ruchu.

Ustaw godzinę wylotu (opcjonalnie)

Używaj tej właściwości tylko w przypadku żądań uwzględniających ruch, w których czas odjazdu musi być w przyszłości. Jeśli nie ustawisz właściwości departureTime, domyślnie będzie ona miała wartość czasu wysłania żądania.

Używaj właściwości departureTime wraz z opcjami TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL, gdy chcesz dostosować sposób, w jaki usługa przewiduje ruch podczas wyboru trasy.

  • TRAFFIC_UNAWARE: Nie zalecane, ponieważ wybór trasy i czasu trwania zależą od sieci dróg i średnich warunków ruchu niezależnych od czasu.

  • TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL:zalecane w przypadku wyjazdów w najbliższej przyszłości, ponieważ te ustawienia uwzględniają aktualne warunki drogowe. Dane o ruchu na żywo stają się ważniejsze i bardziej trafne, im bliżej departureTime jest do teraźniejszości. Im bardziej odległa jest ustawiona godzina odjazdu, tym większe znaczenie mają historyczne warunki ruchu przy wyborze tras.

Przykład: jak wybrać routing z uwzględnieniem ruchu

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