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

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

  1. Ustaw miejsce początkowe i miejsce docelowe.

  2. 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.

  3. Ustaw parametr routingPreference na TRAFFIC_AWARE_OPTIMAL. Ustawienie parametru routingPreference na TRAFFIC_UNAWARE lub TRAFFIC_AWARE jest niezgodne z parametrem trafficModel.

  4. 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"

  5. W masce pola określ pole routes.duration.

    REST

    -H X-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:

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 podróży z użyciem typu modelu ruchu OPTIMISTIC:

"duration": "1238s"

Jeśli zmienisz typ modelu ruchu na PESSIMISTIC, zwrócony czas trwania będzie dłuższy:

"duration": "2436s"