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

Разработчики Европейской экономической зоны (ЕЭЗ)

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

Оба метода API Routes 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"