Укажите тип модели трафика для использования

Модели дорожного движения используют специальные алгоритмы и факторы для прогнозирования того, как условия дорожного движения влияют на общее время в пути по данному маршруту. API маршрутов предлагает различные типы моделей трафика для определения приоритета различных факторов, используемых при расчете продолжительности трафика. Вы можете указать тип модели трафика, который вы хотите использовать в своих маршрутах, при расчете продолжительности ваших маршрутов или матрицы маршрутов. Когда вы задаете тип модели трафика, значение, возвращаемое в поле duration , варьируется в зависимости от выбранной вами модели трафика.

Методы Routes API Compute Routes и Compute Route Matrix поддерживают типы моделей трафика.

По умолчанию оба метода используют тип модели трафика BEST_GUESS .

Чтобы указать тип трафика

  1. Установите пункт отправления и назначения.

  2. Если время вашего отъезда наступит в будущем, укажите это время с помощью параметра departure_time . Если вы не укажете время отправления, по умолчанию будет указано «сейчас».

  3. Выберите модель трафика, которая будет использоваться с параметром trafficModel , и один из следующих типов:

    • BEST_GUESS (по умолчанию), чтобы запросить, чтобы возвращаемое duration_in_traffic представляло собой наилучшую оценку времени в пути с учетом того, что известно как об исторических условиях дорожного движения, так и о реальном трафике. Трафик в реальном времени становится тем более важным, чем ближе к настоящему departure_time . Использование типа BEST_GUESS по умолчанию дает наиболее полезные прогнозы для подавляющего большинства случаев использования.

    • PESSIMISTIC , чтобы запросить, чтобы возвращаемый параметр duration_in_traffic моделировал время на основе исторических условий трафика в дни с плохим трафиком. Этот тип дает расчетную продолжительность, которая, скорее всего, превышает фактическое время в пути в большинстве дней. В отдельные дни с особенно плохими погодными условиями все же эта оценка может превышать эту оценку.

    • OPTIMISTIC , чтобы запросить, чтобы возвращаемый duration_in_traffic моделировал время на основе исторических условий трафика в хорошие дни трафика. Этот тип дает расчетную продолжительность, которая, скорее всего, короче фактического времени в пути в большинстве дней. В отдельные дни с особенно хорошими погодными условиями все же время может быть быстрее, чем эта оценка.

    Например:

    "trafficModel": "OPTIMISTIC"

  4. Укажите поле 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"