При определении лучшего маршрута для совместной поездки самый быстрый маршрут не всегда может быть лучшим вариантом. Возможно, вы захотите спланировать свой маршрут.
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 приведены в разделе Примеры расчета пользовательского маршрута.
Расчет стоимости платных дорог
Подробнее о том, как рассчитать плату за проезд…
Примеры расчета платы за проезд приведены в разделе Примеры расчета пользовательского маршрута.