Modele natężenia ruchu korzystają z określonych algorytmów i czynników, aby przewidywać, jak warunki drogowe wpływają na łączny czas podróży na danej trasie. Interfejs Routes API oferuje różne typy modeli ruchu, aby nadać priorytet różnym czynnikom wykorzystywanym przy obliczaniu czasu trwania ruchu. Możesz określić typ modelu ruchu, który ma być używany przez trasy do obliczania czasu trwania dla tras lub macierzy tras. Gdy ustawisz typ modelu ruchu, wartość zwracana w polu duration
będzie się różnić w zależności od wybranego modelu ruchu.
Zarówno metody Compute Routes
, jak i Compute Route Matrix
interfejsu Routes API 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ę za pomocą parametru
departure_time
. Jeśli nie podasz godziny odjazdu, domyślnie zostanie użyta wartość bieżąca.Wybierz model ruchu, którego chcesz używać z parametrem
trafficModel
i jednym z 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. Aktualne natężenie ruchu staje się ważniejsze, im bliżej jestdeparture_time
. Użycie domyślnego typuBEST_GUESS
daje najbardziej przydatne prognozy w większości przypadków użycia.PESSIMISTIC
, aby zażądać, aby zwrócony elementduration_in_traffic
modelował czas na podstawie historycznych warunków drogowych w dniach o dużym natężeniu ruchu. Ten typ podaje szacowany czas trwania, który w większości dni jest prawdopodobnie dłuższy niż rzeczywisty czas podróży. Czasem w dniach, w których wystąpiły szczególnie złe warunki, mogą jeszcze przekroczyć tę szacowaną wartość.OPTIMISTIC
, aby zażądać, aby zwrócona wartośćduration_in_traffic
modelowała czas na podstawie historycznych warunków drogowych w dniach o dużym natężeniu ruchu. Ten typ podaje szacowany czas trwania, który w większość dni jest prawdopodobnie krótszy niż rzeczywisty czas podróży. W dni o szczególnie dobrych warunkach warunki mogą być jeszcze szybsze niż w szacunkach.
Na przykład:
"trafficModel": "OPTIMISTIC"
PESSIMISTIC
Określ pole
routes.duration
w masce pola.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
To żądanie określa na przykład, że czas odjazdu jest szacowany na podstawie typu modelu natężenia ruchu OPTIMISTIC
w przypadku 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 przy użyciu modelu natężenia ruchu OPTIMISTIC
dla tej podróży:
"duration": "1238s"
Jeśli zmienisz typ modelu ruchu na PESSIMISTIC
, zwrócony czas trwania będzie dłuższy:
"duration": "2436s"