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 podróży z uwzględnieniem 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 w ruchu drogowym, używa wybranego przez Ciebie typu modelu ruchu drogowego.
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-10 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,[]]
