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