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