La API de Routes para Automotive proporciona atributos especializados para los socios de la industria automotriz que desarrollan funciones de navegación en el automóvil. Extiende la API estándar de Routes con atributos adaptados a la industria automotriz.
Qué se incluye en la documentación de la API de Routes para Automotive
Además de la documentación de la API de Routes estándar, la API de Routes para Automotive incluye lo siguiente:
- Notas de la versión (industria automotriz)
- Usa OAuth (Automotive)
- Bibliotecas cliente (Automotive)
- Referencia de REST (Automotive)
- Referencia de RPC (Automotive)
Autoriza tus solicitudes
Para autorizar tus solicitudes a annotatePaths
, debes usar el método de OAuth que se describe a continuación: Cómo usar OAuth (Automotive). Las solicitudes requieren que uses el robo de identidad con OAuth, de manera similar a la forma en que llamas a la API de Automotive Maps (pero con un alcance diferente).
Sin embargo, si llamas a los métodos computeRoutes
o computeRoutesMatrix
, puedes usar cualquiera de los tipos de autorización que se describen en los
documentos habituales de la API de Routes: claves de API o OAuth.
Documentación compartida con la API de Standard Routes
La API de Routes para Automotive comparte documentación con la API de Routes estándar, como los instructivos en la pestaña Guides.
Ten en cuenta que, cuando uses los instructivos estándar de la API de Routes, los vínculos apuntarán a la
referencia estándar. Debes ir al vínculo equivalente en la API de Routes para obtener referencia en Automotive. Para ello, agrega automotive/
después de routes/
en la URL del navegador de la siguiente manera: routes/automotive/
.
Cómo obtener ayuda
Debido a que la API de Routes para Automotive no está disponible de forma pública, te pedimos que evites informar errores en ella en nuestra Herramienta de seguimiento de errores pública. Le proporcionamos a tu equipo un componente de Herramienta de seguimiento de errores específico de la empresa para informar errores. Comunícate con tu contacto de Google si tienes otras inquietudes.
Convenciones y terminología de mayúsculas mediales
En la documentación, se usan principalmente las convenciones de mayúsculas y minúsculas de REST (como annotatePaths
) en lugar de las convenciones de mayúsculas y minúsculas de RPC (AnnotatePaths
). Sin embargo, ambas mayúsculas y minúsculas son igualmente válidas.
Además, aunque es común referirse a annotatePaths
, computeRoutes
o computeRoutesMatrix
como "APIs", en realidad son métodos personalizados. Sin embargo, es posible que se los haga referencia a ellos como métodos o APIs.
DG (disponibilidad general) y funciones experimentales
En esta sección, se describen los atributos únicos de la API de Routes para Automotive. Las siguientes funciones están disponibles para el público en general.
Atributos base expuestos a través de la API de Routes
Polilínea E7 (la polilínea codificada estándar descrita con coordenadas E7 en lugar de E5):
- Evitar transbordadores Consulta
FerryInfo
. - Evitar peajes. Consulta
TollInfo
. - [Vista previa] Selección de la ruta Eco según el tipo de motor. Para obtener más detalles, consulta Cómo buscar una ruta ecológica.
Funciones experimentales
Las siguientes funciones se encuentran en la versión experimental y solo están disponibles para clientes seleccionados:
Atributos base expuestos a través de la API de Routes
- Se toma el token de ruta como una entrada opcional. Consulta
routeToken
enRoute
.
Información que puede estar disponible a lo largo de la polilínea
- Retrasos de embotellamientos medidos en minutos de tráfico Consulta
IncidentType
. - Enums de incidentes sin detalles de incidentes de texto. Consulta
IncidentInfo
.
Consulta PolylineDetails
.
Otras funciones
- Altitud en la ruta. Consulta
AltitudeInfo
. - Buckets de velocidad previstos a lo largo de la ruta (8 buckets, cada uno de 10 a 20 km/h de ancho). Consulta
PredictedSpeedInfo
.
Modificadores de ruta
Puedes activar la siguiente RouteModifiers
desde la API. Sin embargo, es posible que las rutas no respeten el objetivo del modificador porque aún están en desarrollo y pruebas. Si tienes preguntas, comunícate con tu representante de Google.
- Evita las viñetas (
avoidVignettes[]
). Compatible con seis países: Austria, Suiza, Hungría, Eslovenia, Eslovaquia y República Checa. - Permite las rutas para vehículos de alta ocupación (VAO) (
hovPreference
). Se admite en EE.UU. y Canadá. - Evita los túneles (
avoidTunnels
). - Rutas específicas de avances (
totalAxleCount
,totalHeightMm
,totalLengthMm
,totalWidthMm
,totalWeightKg
)