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

Modele ruchu korzystają z określonych algorytmów i czynników, aby przewidywać, jak warunki ruchu wpływają na łączny czas przejazdu na danej trasie. Interfejs Routes API oferuje różne typy modeli ruchu, aby nadawać priorytety różnym czynnikom używanym do obliczania czasu trwania ruchu. Możesz określić typ modelu ruchu, którego trasy chcesz używać do obliczania czasu trwania tras lub macierzy tras. Gdy ustawisz typ modelu ruchu, wartość zwrócona w parametrze Pole duration zmienia się w zależności od wybranego modelu ruchu.

Zarówno metody interfejsu Routes API Compute Routes, jak i Compute Route Matrix obsługują modele ruchu.

Domyślnie obie metody używają 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, podaj go za pomocą parametru departure_time. Jeśli nie podasz godziny odjazdu, przyjmuje wartość domyślną.

  3. Wybierz model ruchu, który ma być używany z parametrem trafficModel, spośród tych typów:

    • BEST_GUESS (domyślnie), aby zażądać zwracania wartości duration_in_traffic to najlepsze oszacowanie czasu podróży, biorąc pod uwagę znane dane historyczne o warunkach i aktualnym natężeniu ruchu. Im bliżej do daty departure_time, tym większy wpływ na wyniki ma ruch na żywo. Użycie domyślnego typu BEST_GUESS zapewnia najbardziej przydatne prognozy w przypadku większości przypadków użycia.

    • PESSIMISTIC, aby zwrócić model duration_in_traffic na podstawie historycznych warunków ruchu w dni z niekorzystnym ruchem. Ten typ podaje szacowany czas trwania, który najprawdopodobniej jest dłuższy niż rzeczywisty czas podróży przez większość dni. W przypadku dni o szczególnie niesprzyjających warunkach może to być jednak wyższa wartość.

    • OPTIMISTIC, aby zwrócić model duration_in_traffic na podstawie historycznych warunków ruchu w dni z dobrym ruchem. Ten typ podaje szacowany czas trwania, który najprawdopodobniej jest krótszy niż rzeczywisty czas podróży przez większość dni. Okazjonalne dni ze szczególnie dobre warunki mogą być nadal szybsze niż szacunki.

    Na przykład: 

    "trafficModel": "OPTIMISTIC"

  4. W polu maski pola określ pole routes.duration.

    REST

    -H X-Goog-FieldMask: routes.duration

    RPC

    const (fieldMask = "routes.duration")

Gdy interfejs Routes API oszacowuje czas w ruchu, wykorzystuje dane o ruchu wybrany przez Ciebie typ modelu.

Przykład: żądanie dotyczące modelu ruchu

Na przykład to żądanie określa, że czas trwania jest szacowany za pomocą metody OPTIMISTIC typ modelu natężenia ruchu dla określonej godziny 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 z użyciem modelu ruchu OPTIMISTIC typ podróży:

"duration": "1238s"

Jeśli zmienisz typ modelu ruchu na PESSIMISTIC, zwrócony czas trwania wyniesie dłużej:

"duration": "2436s"