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:
Ustaw miejsce wylotu i cel podróży.
Jeśli godzina odjazdu przypada w przyszłości, podaj godzinę w
departure_time
. Jeśli nie podasz godziny odjazdu, przyjmuje wartość domyślną.Wybierz model ruchu, który ma być używany z parametrem
trafficModel
, spośród tych typów:BEST_GUESS
(domyślnie), aby zażądać zwracania wartościduration_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 tendeparture_time
. Używany jest typ domyślnyBEST_GUESS
podaje najbardziej przydatne prognozy dla większości i przypadków użycia.PESSIMISTIC
, aby zwrócić modelduration_in_traffic
na podstawie historycznych warunków ruchu w dniach z niekorzystnym ruchem. Ten typ podaje przewidywany czas, który jest dłuższy niż rzeczywisty czas podróży w większości dni. Okazjonalne dni ze szczególnie złymi sytuacjami warunki mogą nadal przekraczać tę szacunkową wartość.OPTIMISTIC
, aby zażądać, aby zwrócony modelduration_in_traffic
zwrócił na podstawie historycznych warunków drogowych w dni o dużym natężeniu ruchu. Ten typ podaje szacowany czas, który jest krótszy od rzeczywistego czasu podróży w większości dni. Okazjonalne dni ze szczególnie dobre warunki mogą być nadal szybsze niż szacunki.
Na przykład:
"trafficModel": "OPTIMISTIC"
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, używając typu modelu ruchu OPTIMISTIC
dla podróży:
"duration": "1238s"
Jeśli zmienisz typ modelu ruchu na PESSIMISTIC
, zwrócony czas trwania wyniesie
dłużej:
"duration": "2436s"