API маршрутов для автомобильной промышленности

API маршрутов для автомобильной промышленности предоставляет специализированные атрибуты автомобильным партнерам, разрабатывающим функции автомобильной навигации. Он расширяет стандартный API маршрутов атрибутами, адаптированными для автомобильной промышленности.

Что включено в документацию Routes API для автомобильной промышленности

Помимо документации по стандартному API маршрутов, API маршрутов для автомобильной промышленности включает в себя следующее:

Авторизуйте свои запросы

Чтобы авторизовать ваши запросы к annotatePaths , вы должны использовать метод OAuth, описанный здесь: Use OAuth (Automotive) . Запросы требуют, чтобы вы использовали олицетворение с помощью OAuth, аналогично тому, как вы вызываете API автомобильных карт (но с другой областью действия).

Однако если вы вызываете методы computeRoutes или computeRoutesMatrix , вы можете использовать любой тип авторизации, описанный в обычной документации Routes API: ключи API или OAuth .

Общая документация с API стандартных маршрутов

API Routes для автомобильной промышленности использует общую документацию со стандартным API Routes, например учебные пособия на вкладке «Руководства» .

Обратите внимание, что при использовании стандартных руководств по API маршрутов ссылки указывают на стандартную ссылку. Вам нужно перейти по эквивалентной ссылке в справочнике Routes API для автомобильной промышленности. Вы можете сделать это, добавив automotive/ после routes/ в URL-адрес браузера, например: routes/automotive/ .

Получать помощь

Поскольку API маршрутов для автомобильной промышленности не является общедоступным, мы просим вас не сообщать об ошибках в нашу общедоступную систему отслеживания ошибок. Мы предоставили вашей команде специальный компонент отслеживания ошибок, в котором можно регистрировать ошибки. Если у вас возникнут другие проблемы, обратитесь к своему контактному лицу в Google.

Соглашения и терминология верблюжьего случая

В документации в основном используются соглашения о регистре REST (например, annotatePaths ) вместо соглашений о регистре RPC ( AnnotatePaths ). Однако оба варианта одинаково действительны.

Кроме того, хотя annotatePaths , computeRoutes или computeRoutesMatrix принято называть «API», на самом деле это пользовательские методы. Однако вы можете увидеть, что их называют либо методами, либо API.

GA (общая доступность) и экспериментальные функции

В этом разделе описаны уникальные атрибуты API маршрутов для автомобильной промышленности. Обычно доступны следующие функции.

Базовые атрибуты, предоставляемые через API маршрутов.

Полилиния E7 ( стандартная кодированная ломаная линия, описываемая координатами E7 вместо E5):

Экспериментальные возможности

Следующие функции находятся в экспериментальной версии и доступны только избранным клиентам:

Базовые атрибуты, предоставляемые через API маршрутов.

  • Маркер маршрута принимается как необязательный вход. См. routeToken в Route .

Информация, которая может быть доступна вдоль полилинии

  • Задержки в пробках измеряются минутами движения. См. IncidentType .
  • Инциденты перечисляются без текстовых подробностей инцидента. См. IncidentInfo .

См. Подробности PolylineDetails .

Другие особенности

  • Высота по маршруту. См. AltitudeInfo .
  • Расчетные сегменты скорости по маршруту (8 сегментов, ширина каждого 10-20 км/ч). См. PredictedSpeedInfo .

Модификаторы маршрута

Вы можете активировать следующие RouteModifiers из API. Однако маршруты могут не соответствовать цели модификатора, поскольку они все еще находятся в стадии разработки и тестирования. Если у вас есть вопросы, обратитесь к представителю Google.

  • Избегайте виньеток ( avoidVignettes[] ). Поддерживается шесть стран: Австрия, Швейцария, Венгрия, Словения, Словакия и Чехия.
  • Разрешить движение транспортных средств с большим количеством пассажиров (HOV) ( hovPreference ). Поддерживается в США и Калифорнии.
  • Избегайте туннелей ( avoidTunnels ).
  • Маршруты, специфичные для прицепа ( totalAxleCount , totalHeightMm , totalLengthMm , totalWidthMm , totalWeightKg ).