При выборе маршрута для поездки с попутчиками самый быстрый вариант не всегда будет лучшим. Возможно, вам нужно спланировать маршрут.
Routes Preferred API позволяет планировать маршрут, указывая цель маршрута с помощью метода ComputeCustomRoutes.
Метод ComputeCustomRoutes также помогает соблюдать маршрут, поскольку позволяет свести к минимуму разницу между маршрутом, выбранным оператором, и маршрутом, по которому едет водитель.
Чтобы в полной мере воспользоваться преимуществами планирования маршрутов, используйте Routes Preferred API и Navigation SDK.
Включите метод ComputeCustomRoutes
Чтобы использовать метод ComputeCustomRoutes в коде, его нужно включить. Подробнее о том, как включить методы Routes Preferred API, рассказывается в руководстве по началу работы.
Как использовать метод ComputeCustomRoutes
Метод ComputeCustomRoutes требует, чтобы вы указали маску поля ответа во входных данных. Маску поля ответа можно указать с помощью параметра URL $fields или fields либо с помощью заголовка HTTP/gRPC X-Goog-FieldMask. Дополнительную информацию можно найти в разделе Системные параметры.
Значение маски поля представляет собой список путей к полям, разделенных запятыми. Каждый путь к полю представляет собой список названий полей, разделенных точками, которые отражают иерархию сообщения. Название поля – это ключ объекта JSON или название тега поля protobuf. Путь к полю начинается с типа сообщения ответа верхнего уровня, за которым может следовать одна или несколько точек, а затем название поля следующего уровня. Как правило, пути к полям создаются следующим образом:
topLevelField[.secondLevelField][.thirdLevelField][...]
Маска поля в специальном случае представляет собой подстановочный знак "*", который выбирает все поля корневого уровня.
Статьи по теме
Примеры использования метода ComputeCustomRoutes приведены в разделе Примеры расчета маршрута.
Расчет стоимости проезда по платным дорогам
Информацию о том, как рассчитываются сборы за проезд по платным дорогам, можно найти в разделе Как рассчитываются сборы за проезд по платным дорогам.
Примеры расчета платы за проезд по платным дорогам можно найти в разделе Примеры расчета маршрута.