API Routes Preferred предоставляет три предпочтительных варианта маршрутизации. Они различаются степенью учета дорожных условий при расчете маршрута. Каждый предпочтительный вариант маршрутизации дает результаты, которые в определенной степени отличаются по качеству маршрута, расчетному времени прибытия и задержке ответа.
Информация о дорожной ситуации
Условия дорожного движения характеризуют интенсивность транспортного потока. Например:
В отсутствие заторов дорожная обстановка считается нормальной, и движение осуществляется с обычной беспрепятственной скоростью.
В часы пик плотность движения увеличивается, что приводит к замедлению потока и, как следствие, к слабому или умеренному дорожному движению.
В условиях плотного транспортного потока интенсивность движения резко снижается, что приводит к образованию заторов.
Водители невнимательны
При установке параметра маршрутизации TRAFFIC_UNAWARE маршруты рассчитываются без учета дорожных условий. Этот параметр маршрутизации обеспечивает минимальную задержку ответа (ответы возвращаются быстрее всего).
Используйте этот параметр маршрутизации, если вам нужны максимально быстрые ответы, и приблизительных данных маршрутизации будет достаточно.
Будьте внимательны на дороге
При установке параметра маршрутизации TRAFFIC_AWARE маршруты рассчитываются с учетом дорожных условий. В результате маршрут и его детали более точно отражают реальные условия. Поскольку это повышение качества данных происходит за счет увеличения задержки ответа, применяются оптимизации производительности для значительного снижения задержки.
Используйте этот параметр маршрутизации, если вам нужны более точные данные о маршруте, и при этом вас не смущает умеренное увеличение задержки при получении ответов.
Оптимизация с учетом дорожной ситуации
При установке параметра маршрутизации TRAFFIC_AWARE_OPTIMAL маршруты рассчитываются с учетом дорожных условий, но оптимизация производительности не применяется. В этом режиме сервер выполняет более тщательный поиск по дорожной сети для нахождения оптимального маршрута.
Этот параметр маршрутизации обеспечивает максимальную задержку ответа (т.е. ответы возвращаются с наибольшей задержкой). Используйте этот параметр маршрутизации, если вам нужны результаты высочайшего качества, независимо от времени ответа.
Пример
Приведенный ниже JSON-код демонстрирует, как установить предпочтительный маршрут в теле сообщения запроса.
{ "origin":{ "location":{ "latLng":{ "latitude":37.419734, "longitude":-122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude":37.417670, "longitude":-122.079595 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE_OPTIMAL" }