Określ typ modelu ruchu, którego chcesz użyć

Modele ruchu korzystają z określonych algorytmów i czynników, aby przewidywać, jak warunki ruchu wpływają na łączny czas przejazdu na danej trasie. Interfejs Routes API oferuje różne typy modeli ruchu, aby nadawać priorytety różnym czynnikom używanym do obliczania czasu trwania ruchu. Możesz określić typ modelu ruchu, którego trasy chcesz używać do obliczania czasu trwania tras lub macierzy tras. Gdy ustawisz typ modelu ruchu, wartość zwrócona w polu duration będzie się różnić w zależności od wybranego modelu ruchu.

Zarówno metody interfejsu Routes API Compute Routes, jak i Compute Route Matrix obsługują typy modeli ruchu.

Domyślnie obie metody używają modelu ruchu BEST_GUESS.

Określanie typu ruchu

  1. Ustaw miejsce wylotu i cel podróży.

  2. Jeśli godzina odjazdu przypada w przyszłości, podaj godzinę za pomocą parametru departure_time. Jeśli nie podasz godziny odjazdu, domyślnie zostanie użyta wartość bieżąca.

  3. Wybierz model ruchu, który ma być używany z parametrem trafficModel, spośród tych typów:

    • BEST_GUESS (domyślnie), by zażądać, by zwrócona wartość duration_in_traffic stanowiła najlepsze oszacowanie czasu podróży, biorąc pod uwagę zarówno historyczne warunki, jak i aktualne natężenie ruchu. Im bliżej do daty departure_time, tym większy wpływ na wyniki ma ruch na żywo. Użycie domyślnego typu BEST_GUESS zapewnia najbardziej przydatne prognozy w przypadku większości przypadków użycia.

    • PESSIMISTIC, aby zwrócić model duration_in_traffic na podstawie historycznych warunków ruchu w dni z niekorzystnym ruchem. Ten typ podaje przewidywany czas, który jest dłuższy niż rzeczywisty czas podróży w większości dni. W przypadku dni o szczególnie niesprzyjających warunkach może się to jednak nie sprawdzić.

    • OPTIMISTIC, aby zwrócić model duration_in_traffic na podstawie historycznych warunków ruchu w dni z dobrym ruchem. Ten typ podaje szacowany czas, który jest krótszy od rzeczywistego czasu podróży w większości dni. W dni o szczególnie dobrych warunkach warunki mogą być jeszcze szybsze niż w szacunkach.

    Na przykład:

    "trafficModel": "OPTIMISTIC"

  4. W polu maski pola określ pole routes.duration.

    REST

    -H X-Goog-FieldMask: routes.duration

    RPC

    const (fieldMask = "routes.duration")

Gdy interfejs Routes API szacuje czas w ruchu, używa żądanego typu modelu ruchu.

Przykład: żądanie dotyczące modelu ruchu

Na przykład w tym żądaniu określono, że czas trwania ma być szacowany za pomocą typu modelu ruchu OPTIMISTIC w określonym czasie wyjazdu:

curl -X POST -H 'content-type: application/json' -d ' {
"origin": {
  "address": "Kyoto, Japan"
  },
"destination": {
  "placeId": "ChIJrYtcv-urAWAR3XzWvXv8n_s"
  },
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE_OPTIMAL",
"trafficModel": "OPTIMISTIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

To zapytanie zwraca szacowany czas trwania, korzystając z tego typu modelu natężenia ruchu: OPTIMISTIC.

"duration": "1238s"

Jeśli zmienisz typ modelu ruchu na PESSIMISTIC, zwrócony czas trwania będzie dłuższy:

"duration": "2436s"