Установите уровень данных о трафике

Выбранные вами настройки трафика обеспечивают баланс между точностью сведений о маршруте и производительностью запросов одним из двух способов:

  • С учетом трафика – получение наиболее точных результатов (более высокая задержка).

  • Без учета трафика – результаты возвращаются как можно быстрее (минимальная задержка).

Делая запрос, подумайте, лучше ли вернуть как можно более точные результаты или как можно быстрее. API маршрутов предоставляет параметры, позволяющие контролировать качество данных ответа и задержку ответа.

Как установить уровень трафика

API маршрутов предоставляет RoutingPreference (REST) ​​и RoutingPreference (gRPC), которые позволяют указать предпочтения маршрутизации для расчета маршрутов.

По умолчанию используются результаты без учета трафика. Вы выбираете параметры трафика с помощью предпочтений маршрутизации TRAFFIC_UNAWARE , TRAFFIC_AWARE и TRAFFIC_AWARE_OPTIMAL . Каждое предпочтение маршрутизации дает результаты, которые различаются качеством маршрута, расчетным расчетным временем прибытия и задержкой ответа.

Условия дорожного движения

Условия дорожного движения характеризуют скорость транспортного потока:

  • Нормальное движение : пробок нет, движение транспорта осуществляется с нормальной скоростью.

  • Движение от легкого до умеренного : увеличение заторов, скорость движения транспорта снижается.

  • Интенсивное движение : сильные заторы со значительным снижением скорости движения.

Трафик не знает

TRAFFIC_UNAWARE — настройка по умолчанию. Используйте эту настройку маршрутизации, если вы хотите, чтобы ответы возвращались как можно быстрее, а приблизительные сведения о маршрутизации достаточно хороши.

Маршруты TRAFFIC_UNAWARE рассчитываются без учета текущих условий дорожного движения. Такое предпочтение маршрутизации обеспечивает самый быстрый ответ на запрос (наименьшую задержку).

Если вы выберете TRAFFIC_UNAWARE , выбранный маршрут и продолжительность будут основаны на дорожной сети и средних условиях дорожного движения, не зависящих от времени, а не на текущих дорожных условиях. Следовательно, маршруты могут включать дороги, которые временно закрыты. Результаты для данного запроса могут меняться со временем из-за изменений в дорожной сети, обновленных средних условий дорожного движения и распределенного характера услуги. Результаты также могут различаться между почти эквивалентными маршрутами в любое время и частоту.

Вот ответы, которые вы увидите:

  • duration — содержит расчетное время прибытия для маршрута.

  • staticDuration : расчетное время прибытия для маршрута, учитывающее только историческую информацию о трафике. Для TRAFFIC_UNAWARE оно содержит то же значение, что и duration .

В курсе дорожного движения

Используйте эту настройку маршрутизации, если вам нужны более точные сведения о маршрутизации, чем TRAFFIC_UNAWARE , и при этом вы не возражаете, если ответы возвращаются с умеренным увеличением задержки.

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

Вот ответы, которые вы увидите:

  • duration : расчетное время прибытия с учетом информации о дорожном движении в реальном времени.

  • staticDuration Расчетное время прибытия для маршрута, учитывающее только историческую информацию о трафике.

Оптимальный с учетом трафика

Используйте эту настройку маршрутизации, если вам нужны результаты высочайшего качества, независимо от того, сколько времени займет ответ. Это предпочтение маршрутизации имеет самую большую задержку возврата ответов (самая высокая задержка).

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

Предпочтение маршрутизации TRAFFIC_AWARE_OPTIMAL эквивалентно режиму, используемому на сайте maps.google.com и в мобильном приложении Google Maps.

Когда вы используете эту опцию с вычислением матрицы маршрутов, количество элементов в запросе (количество источников × количество пунктов назначения) не может превышать

  1. Дополнительные сведения об ограничениях матрицы маршрутов см. в разделе Вычисление матрицы маршрутов .

Вот ответы, которые вы увидите:

  • duration : расчетное время прибытия для маршрута с учетом информации о дорожной ситуации в реальном времени.

  • staticDuration : расчетное время прибытия для маршрута, учитывающее только историческую информацию о трафике.

Установите время отправления (необязательно)

Используйте это свойство только для запросов с учетом трафика, где время отправления должно быть в будущем. Если вы не установили свойство departureTime , по умолчанию оно будет равно времени, когда вы делаете запрос.

Используйте свойство departureTime вместе с параметрами TRAFFIC_AWARE и TRAFFIC_AWARE_OPTIMAL , если вы хотите настроить способ прогнозирования трафика службой при выборе маршрута.

  • TRAFFIC_UNAWARE : Не рекомендуется , поскольку выбор маршрута и продолжительности зависит от дорожной сети и средних условий движения, не зависящих от времени.

  • TRAFFIC_AWARE и TRAFFIC_AWARE_OPTIMAL : рекомендуются для отправлений, которые состоятся в ближайшем будущем, поскольку эти предпочтения учитывают текущие условия движения. Живой трафик становится тем более важным и актуальным, чем ближе время departureTime к настоящему моменту. Чем дальше вы устанавливаете время отправления в будущее, тем больше внимания уделяется историческим условиям движения при выборе маршрутов.

Пример: Как выбрать маршрутизацию с учетом трафика

Следующий код JSON демонстрирует, как установить предпочтение маршрутизации TRAFFIC_AWARE_OPTIMAL в теле объекта сообщения запроса.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}

Настройка трафика на полилиниях

API маршрутов позволяет запрашивать информацию об условиях дорожного движения вдоль ломаной линии с учетом трафика . Дополнительную информацию см. в разделе Запрос полилиний .