Routes Preferred API предлагает три варианта расчета маршрутов. Они отличаются тем, в какой степени учитывают загруженность дорог при расчете маршрута. Каждый вариант предпочтительного маршрута дает результаты, которые в определенной степени различаются по качеству маршрута, расчетному времени прибытия и задержке ответа.
О загруженности дорог
Загруженность дорог характеризует скорость движения транспорта. Пример:
Если заторов нет, загруженность дорог считается нормальной, а транспорт движется с обычной скоростью.
По мере приближения часа пик плотность движения увеличивается, что приводит к замедлению движения и возникновению легкой или умеренной загруженности дорог.
В пробках скорость потока падает до нуля, что приводит к высокой загруженности дорог.
Без учета трафика
Если вы зададите предпочтительный маршрут 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" }