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

Modele ruchu używają określonych algorytmów i czynników, aby przewidywać, jak ruch mają wpływ na łączny czas podróży na danej trasie. Interfejs Routes API udostępnia różne typy modeli ruchu, aby nadać priorytet różnym czynnikom wykorzystywanym obliczanie czasu trwania ruchu. Możesz określić typ modelu ruchu np. trasy, które mają być używane do obliczania czasu trwania Twoich tras lub tras lub macierz. Gdy ustawisz typ modelu ruchu, wartość zwrócona w parametrach Pole duration zmienia się w zależności od wybranego modelu ruchu.

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

Domyślnie obie metody korzystają z typu modelu ruchu BEST_GUESS.

Aby określić typ ruchu:

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

  2. Jeśli godzina odjazdu przypada w przyszłości, podaj godzinę w departure_time. Jeśli nie podasz godziny odjazdu, przyjmuje wartość domyślną.

  3. Wybierz model ruchu, którego chcesz używać z parametrem trafficModel i jednego z tych typów:

    • BEST_GUESS (domyślnie), aby zażądać zwracania wartości duration_in_traffic to najlepsze oszacowanie czasu podróży, biorąc pod uwagę znane dane historyczne o warunkach i aktualnym natężeniu ruchu. Rzeczywisty ruch jest większy ważne, im bliżej jest ten departure_time. Używany jest typ domyślny BEST_GUESS podaje najbardziej przydatne prognozy dla większości i przypadków użycia.

    • PESSIMISTIC, aby zażądać, aby zwrócony model duration_in_traffic zwrócił na podstawie historycznych warunków drogowych w dniach o dużym natężeniu ruchu. Ten typ podaje szacowany czas trwania, który najprawdopodobniej jest dłuższy niż rzeczywisty czas podróży przez większość dni. Okazjonalne dni ze szczególnie złymi sytuacjami warunki mogą nadal przekraczać tę szacunkową wartość.

    • OPTIMISTIC, aby zażądać, aby zwrócony model duration_in_traffic zwrócił na podstawie historycznych warunków drogowych w dni o dużym natężeniu ruchu. Ten typ podaje szacowany czas trwania, który najprawdopodobniej jest krótszy niż rzeczywisty czas podróży przez większość dni. Okazjonalne dni ze szczególnie dobre warunki mogą być nadal szybsze niż szacunki.

    Na przykład:

    "trafficModel": "OPTIMISTIC"

  4. Określ pole routes.duration w masce pola.

    REST

    -H X-Goog-FieldMask: routes.duration

    RPC

    const (fieldMask = "routes.duration")

Gdy interfejs Routes API oszacowuje czas w ruchu, wykorzystuje dane o ruchu wybrany przez Ciebie typ modelu.

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

Na przykład to żądanie określa, że czas trwania jest szacowany za pomocą metody OPTIMISTIC typ modelu natężenia ruchu dla określonej godziny odjazdu:

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 żądanie zwraca szacowany czas trwania z użyciem modelu ruchu OPTIMISTIC typ podróży:

"duration": "1238s"

Jeśli zmienisz typ modelu ruchu na PESSIMISTIC, zwrócony czas trwania wyniesie dłużej:

"duration": "2436s"