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 ruchu wpływają na łączny czas podróży na danej trasie. Interfejs Routes API oferuje różne typy modeli ruchu, aby priorytetowo traktować różne czynniki używane do obliczania czasu trwania w ruchu. Możesz określić typ modelu ruchu, którego mają używać Twoje trasy podczas obliczania czasu trwania trasy 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.

Obie metody interfejsu Routes API, Compute Routes i Compute Route Matrix, obsługują typy modeli ruchu.

Domyślnie obie metody używają typu modelu ruchu BEST_GUESS.

Aby określić typ ruchu

  1. Ustaw miejsce początkowe i miejsce docelowe.

  2. Jeśli czas wyjazdu jest w przyszłości, dodaj go za pomocą parametru departure_time. Jeśli nie określisz czasu wyjazdu, domyślnie zostanie ustawiony bieżący czas.

  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ślny) – aby poprosić, aby zwracany parametr duration_in_traffic był najlepszym oszacowaniem czasu podróży na podstawie informacji o historycznych warunkach na drodze i aktualnym natężeniu ruchu. Im bliżej jest departure_time do bieżącego czasu, tym większe znaczenie ma aktualne natężenie ruchu. Użycie domyślnego typu BEST_GUESS zapewnia najbardziej przydatne prognozy w zdecydowanej większości przypadków użycia.

    • PESSIMISTIC – aby poprosić, aby zwracany parametr duration_in_traffic modelował 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 będzie prawdopodobnie dłuższy niż rzeczywisty czas podróży. W wyjątkowych dniach, w których warunki są szczególnie złe, szacunek ten może zostać przekroczony.

    • OPTIMISTIC – aby poprosić, aby zwracany parametr duration_in_traffic modelował czas na podstawie historycznych warunków na drodze w dniach o małym natężeniu ruchu. Ten typ podaje szacowany czas trwania, który w większości dni będzie prawdopodobnie krótszy niż rzeczywisty czas podróży. W wyjątkowych dniach, w których warunki są szczególnie dobre, czas podróży może być krótszy niż ten szacunek.

    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 w określonym czasie wyjazdu:

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 przy użyciu 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"