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

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

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"