API маршрутов для автомобильной промышленности предоставляет специализированные атрибуты автомобильным партнерам, разрабатывающим функции автомобильной навигации. Он расширяет стандартный API маршрутов атрибутами, адаптированными для автомобильной промышленности.
Что включено в документацию Routes API для автомобильной промышленности
Помимо документации по стандартному API маршрутов, API маршрутов для автомобильной промышленности включает в себя следующее:
- Примечания к выпуску (автомобильная промышленность)
- Используйте OAuth (автомобильная промышленность)
- Клиентские библиотеки (автомобильная промышленность)
- Справочник REST (автомобильная промышленность)
- Справочник RPC (автомобильная промышленность)
Авторизуйте свои запросы
Чтобы авторизовать ваши запросы к 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):
- Избегайте паромов. См.
FerryInfo
- Избегайте дорожных сборов. См.
TollInfo
- [Предварительный просмотр] Выбор Eco Route в зависимости от типа двигателя. Дополнительные сведения см. в разделе «Проектирование экологически чистого маршрута» .
Экспериментальные возможности
Следующие функции находятся в экспериментальной версии и доступны только избранным клиентам:
Базовые атрибуты, предоставляемые через API маршрутов.
- Маркер маршрута принимается как необязательный вход. См.
routeToken
вRoute
.
Информация, которая может быть доступна вдоль полилинии
- Задержки в пробках измеряются минутами движения. См.
IncidentType
. - Инциденты перечисляются без текстовых подробностей инцидента. См.
IncidentInfo
.
См. Подробности PolylineDetails
.
Другие особенности
- Высота по маршруту. См.
AltitudeInfo
. - Расчетные сегменты скорости по маршруту (8 сегментов, ширина каждого 10-20 км/ч). См.
PredictedSpeedInfo
.
Модификаторы маршрута
Вы можете активировать следующие RouteModifiers
из API. Однако маршруты могут не соответствовать цели модификатора, поскольку они все еще находятся в стадии разработки и тестирования. Если у вас есть вопросы, обратитесь к представителю Google.
- Избегайте виньеток (
avoidVignettes[]
). Поддерживается шесть стран: Австрия, Швейцария, Венгрия, Словения, Словакия и Чехия. - Разрешить движение транспортных средств с большим количеством пассажиров (HOV) (
hovPreference
). Поддерживается в США и Калифорнии. - Избегайте туннелей (
avoidTunnels
). - Маршруты, специфичные для прицепа (
totalAxleCount
,totalHeightMm
,totalLengthMm
,totalWidthMm
,totalWeightKg
).