Эта страница переведена с помощью Cloud Translation API.

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

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

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

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

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

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

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

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

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

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

Нормальное движение : никаких заторов, транспорт движется с нормальной скоростью.
Низкая или умеренная интенсивность движения : увеличение заторов, снижение скорости движения.
Интенсивное движение : серьезные заторы, значительно сниженная скорость движения.

Неосведомленность о дорожном движении

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

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

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

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

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

Информация о дорожном движении

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

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

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

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

Оптимальный с учетом дорожного движения

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

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

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

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

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

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

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"
}

Настроить движение по полилиниям

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