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

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

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

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

  • Не учитывая дорожную ситуацию — возвращайте результаты как можно быстрее (минимальная задержка).

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

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

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.

При использовании этой опции с функцией Compute Route Matrix количество элементов в запросе (количество источников × количество пунктов назначения) не может превышать

  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 маршрутов позволяет запрашивать информацию о дорожной обстановке вдоль ломаной линии с учётом дорожного движения . Подробнее см. в разделе «Запрос ломаных» .