Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)
Modele ruchu wykorzystują określone algorytmy i czynniki, aby przewidywać, jak warunki drogowe wpływają na całkowity czas podróży na danej trasie. Interfejs Routes API oferuje różne typy modeli ruchu, aby priorytetyzować różne czynniki używane do obliczania czasu trwania w ruchu. Możesz określić typ modelu ruchu, którego chcesz używać do obliczania czasu trwania 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 interfejsu API Tras Compute Routes, jak i Compute Route Matrix obsługują typy modeli ruchu.
Domyślnie obie metody używają typu modelu ruchu BEST_GUESS.
Określanie typu ruchu
Ustaw miejsce początkowe i miejsce docelowe.
Jeśli czas odjazdu jest w przyszłości, podaj go za pomocą parametru departure_time. Jeśli nie określisz godziny odjazdu, domyślnie zostanie ustawiona bieżąca godzina.
Ustaw parametr routingPreference na TRAFFIC_AWARE_OPTIMAL. Ustawienie parametru routingPreference na TRAFFIC_UNAWARE lub TRAFFIC_AWARE jest niezgodne z parametrem trafficModel.
Wybierz model ruchu, który ma być używany z parametrem trafficModel, i jeden z tych typów:
BEST_GUESS (domyślnie) – żądanie, aby zwrócony duration_in_traffic był najlepszym oszacowaniem czasu podróży na podstawie znanych historycznych i bieżących warunków ruchu. Aktualne informacje o natężeniu ruchu stają się tym ważniejsze, im bliżej departure_time jest do teraźniejszości. Używanie domyślnego typu BEST_GUESS zapewnia najbardziej przydatne prognozy w większości przypadków.
PESSIMISTIC, aby poprosić o to, aby zwrócony model duration_in_traffic modelował czas na podstawie historycznych warunków ruchu w dniach, w których występuje zły ruch.
Ten typ podaje szacowany czas trwania, który w większości dni jest dłuższy niż rzeczywisty czas podróży. W niektóre dni, gdy warunki są szczególnie niekorzystne, może on być wyższy.
OPTIMISTIC, aby poprosić o to, aby zwrócony model duration_in_traffic określał czas na podstawie historycznych warunków ruchu w dniach, w których ruch był dobry.
Ten typ podaje szacowany czas trwania, który w większości dni jest krótszy niż rzeczywisty czas podróży. W dni, w których warunki są szczególnie dobre, czas dostawy może być krótszy niż szacowany.
Na przykład:
"trafficModel":"OPTIMISTIC"
W masce pola określ pole routes.duration.
REST
-HX-Goog-FieldMask:routes.duration
RPC
const(fieldMask="routes.duration")
Gdy interfejs Routes API szacuje czas podróży z uwzględnieniem ruchu, korzysta z wybranego przez Ciebie typu modelu ruchu.
Przykład: żądanie modelu ruchu
Na przykład to żądanie określa, że czas trwania ma być szacowany przy użyciu typu modelu ruchu OPTIMISTIC o określonej godzinie odjazdu:
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-20 UTC."],[[["\u003cp\u003eThe Routes API offers different traffic models (\u003ccode\u003eBEST_GUESS\u003c/code\u003e, \u003ccode\u003ePESSIMISTIC\u003c/code\u003e, \u003ccode\u003eOPTIMISTIC\u003c/code\u003e) to predict travel times based on various traffic conditions.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify the desired traffic model when calculating routes, with \u003ccode\u003eBEST_GUESS\u003c/code\u003e being the default, providing the most useful predictions for most use cases.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePESSIMISTIC\u003c/code\u003e models travel time based on bad traffic days, likely resulting in a longer estimated duration, while \u003ccode\u003eOPTIMISTIC\u003c/code\u003e uses good traffic days, potentially resulting in a shorter duration.\u003c/p\u003e\n"],["\u003cp\u003eLive traffic information is integrated into the \u003ccode\u003eBEST_GUESS\u003c/code\u003e model, making it potentially shorter than \u003ccode\u003eOPTIMISTIC\u003c/code\u003e or longer than \u003ccode\u003ePESSIMISTIC\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTo use traffic models, include the \u003ccode\u003etrafficModel\u003c/code\u003e parameter in your request and specify \u003ccode\u003eroutes.duration\u003c/code\u003e in the field mask.\u003c/p\u003e\n"]]],["The Routes API's traffic models predict travel time, offering `BEST_GUESS` (default), `PESSIMISTIC` (longer), and `OPTIMISTIC` (shorter) durations. To use, set the origin, destination, and optional `departure_time`. Choose a `trafficModel` type and specify `routes.duration` in the field mask. The API calculates traffic-affected durations based on the selected model. Using `BEST_GUESS` integrate live information. The default is `BEST_GUESS`, and the duration returned varies depending on the chosen model. The service is pre-GA, it might have limited support and changes.\n"],null,[]]
