Модели дорожного движения используют специальные алгоритмы и факторы для прогнозирования того, как условия дорожного движения влияют на общее время в пути по данному маршруту. API маршрутов предлагает различные типы моделей трафика для определения приоритета различных факторов, используемых при расчете продолжительности трафика. Вы можете указать тип модели трафика, который вы хотите использовать в своих маршрутах, при расчете продолжительности ваших маршрутов или матрицы маршрутов. Когда вы задаете тип модели трафика, значение, возвращаемое в поле duration
, варьируется в зависимости от выбранной вами модели трафика.
Оба метода Routes API Compute Routes
и Compute Route Matrix
поддерживают типы моделей трафика.
По умолчанию оба метода используют тип модели трафика BEST_GUESS
.
Чтобы указать тип трафика
Установите пункт отправления и назначения.
Если время вашего отъезда наступит в будущем, укажите это время с помощью параметра
departure_time
. Если вы не укажете время отправления, по умолчанию будет указано «сейчас».Выберите модель трафика, которая будет использоваться с параметром
trafficModel
, и один из следующих типов:BEST_GUESS
(по умолчанию), чтобы запросить, чтобы возвращаемыйduration_in_traffic
был наилучшей оценкой времени в пути с учетом того, что известно как об исторических условиях дорожного движения, так и о реальном трафике. Трафик в режиме реального времени становится тем более важным, чем ближе к настоящему моментуdeparture_time
. Использование типаBEST_GUESS
по умолчанию дает наиболее полезные прогнозы для подавляющего большинства случаев использования.PESSIMISTIC
чтобы запросить, чтобы возвращаемыйduration_in_traffic
моделировал время на основе исторических условий трафика в дни с плохим трафиком. Этот тип дает расчетную продолжительность, которая, скорее всего, превышает фактическое время в пути в большинстве дней. В отдельные дни с особенно плохими условиями погода все же может превышать эту оценку.OPTIMISTIC
чтобы запросить, чтобы возвращаемыйduration_in_traffic
моделировал время на основе исторических условий трафика в хорошие дни трафика. Этот тип дает расчетную продолжительность, которая, скорее всего, короче фактического времени в пути в большинстве дней. В отдельные дни с особенно хорошими погодными условиями все же время может быть быстрее, чем эта оценка.
Например:
"trafficModel": "OPTIMISTIC"
Укажите поле
routes.duration
в маске поля.ОТДЫХ
-H X-Goog-FieldMask: routes.duration
ПКП
const (fieldMask = "routes.duration")
Когда API маршрутов оценивает время трафика, он использует запрошенный вами тип модели трафика.
Пример: запрос модели трафика
Например, этот запрос указывает, что продолжительность оценивается с использованием типа модели трафика OPTIMISTIC
в определенное время отправления:
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'
Этот запрос возвращает расчетную продолжительность поездки с использованием типа модели трафика OPTIMISTIC
:
"duration": "1238s"
Если вы измените тип модели трафика на PESSIMISTIC
, возвращаемая продолжительность будет больше:
"duration": "2436s"