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

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Modele ruchu wykorzystują określone algorytmy i czynniki do przewidywania, 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 interfejs Routes API Compute Routes, jak i metody 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 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), aby poprosić o zwrócenie wartości duration_in_traffic, która jest najlepszym oszacowaniem czasu podróży na podstawie historycznych warunków na drodze i aktualnego natężenia 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 zwrócenie duration_in_traffic, które modeluje czas na podstawie historycznych warunków na drodze w dniach o dużym natężeniu ruchu. 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 zwrócenie duration_in_traffic, który modeluje czas na podstawie historycznych warunków na drodze w dniach o dobrym natężeniu ruchu. Ten typ podaje szacowany czas trwania, który w większości dni jest krótszy niż rzeczywisty czas podróży. W szczególnie sprzyjających warunkach 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 w ruchu, używa typu modelu ruchu, o który prosisz.

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 będzie dłuższy:

"duration": "2436s"