L'API Routes pour l'automobile fournit des attributs spécialisés aux partenaires du secteur automobile qui développent des fonctionnalités de navigation embarquée. Il étend l'API Routes standard avec des attributs adaptés à l'industrie automobile.
Contenu de la documentation de l'API Routes pour l'automobile
En plus de la documentation de l'API Routes standard, l'API Routes pour l'automobile inclut les éléments suivants:
- Notes de version (automobile)
- Utiliser OAuth (automobile)
- Bibliothèques clientes (Automotive)
- Documentation de référence REST (automobile)
- Documentation de référence sur RPC (automobile)
Autoriser vos requêtes
Pour autoriser vos requêtes à annotatePaths
, vous devez utiliser la méthode OAuth décrite dans la section Utiliser OAuth (automobile). Les requêtes nécessitent que vous utilisiez l'emprunt d'identité avec OAuth, de la même manière que vous appelez l'API Automotive Maps (mais avec un champ d'application différent).
Toutefois, si vous appelez les méthodes computeRoutes
ou computeRoutesMatrix
, vous pouvez utiliser l'un des types d'autorisation décrits dans la documentation standard de l'API Routes: Clés API ou OAuth.
Documentation partagée avec l'API Standard Routes
L'API Routes pour Automotive partage de la documentation avec l'API Routes standard, par exemple des tutoriels dans l'onglet Guides.
Notez que lorsque vous utilisez les tutoriels de l'API Routes standards, les liens pointent vers la documentation de référence standard. Vous devez accéder au lien équivalent dans l'API Routes pour obtenir des informations sur l'automobile. Pour ce faire, ajoutez automotive/
après routes/
dans l'URL du navigateur, comme ceci: routes/automotive/
.
Obtenir de l'aide
Étant donné que l'API Routes pour Automotive n'est pas accessible au public, nous vous demandons d'éviter de signaler des bugs dans notre outil public Issue Tracker. Nous avons fourni à votre équipe un composant Issue Tracker spécifique à l'entreprise dans lequel vous pouvez signaler des bugs. Contactez votre représentant Google si vous avez d'autres questions.
Conventions et terminologie Camel-Case
La documentation utilise principalement les conventions de casse de chameau REST (telles que annotatePaths
) au lieu des conventions de casse RPC (AnnotatePaths
). Cependant, les deux casses sont identiques.
De plus, bien qu'il soit courant de désigner annotatePaths
, computeRoutes
ou computeRoutesMatrix
comme "API", il s'agit en réalité de méthodes personnalisées. Cependant, on les appelle méthodes ou API.
Fonctionnalités en disponibilité générale et expérimentales
Cette section décrit les attributs uniques de l'API Routes pour l'automobile. Les fonctionnalités suivantes sont en disponibilité générale.
Attributs de base exposés via l'API Routes
Polyligne E7 (polyligne encodée standard décrite avec des coordonnées E7 au lieu de E5):
- Éviter les ferries. Consultez
FerryInfo
- Éviter les péages. Consultez
TollInfo
- [Aperçu] Sélection de l'itinéraire éco en fonction du type de moteur. Pour en savoir plus, consultez Trouver un itinéraire économe en carburant.
Fonctionnalités expérimentales
Les fonctionnalités suivantes sont en version expérimentale et ne sont disponibles que pour certains clients:
Attributs de base exposés via l'API Routes
- Jeton de routage utilisé comme entrée facultative. Consultez
routeToken
dansRoute
.
Informations pouvant être disponibles le long de la polyligne
- Les retards liés aux embouteillages sont mesurés en minutes de trafic. Voir
IncidentType
. - Énumérations des incidents sans détails textuels sur l'incident. Voir
IncidentInfo
.
Voir PolylineDetails
.
Autres fonctionnalités
- Altitude sur le trajet Voir
AltitudeInfo
. - Buckets de vitesse prévus sur l'itinéraire (8 buckets, chacun d'une largeur comprise entre 10 et 20 km/h). Voir
PredictedSpeedInfo
.
Modificateurs de route
Vous pouvez déclencher le RouteModifiers
suivant à partir de l'API. Cependant, les routes peuvent ne pas respecter l'objectif de modificateur, car elles sont encore en cours de développement et de test. Pour toute question, contactez votre représentant Google.
- Évitez les vignettes (
avoidVignettes[]
). Disponible dans six pays: Autriche, Suisse, Hongrie, Slovénie, Slovaquie et République tchèque. - Autoriser les routes réservées aux véhicules à occupation multiple (
hovPreference
). Fonctionnalité disponible au Canada et aux États-Unis. - Évitez les tunnels (
avoidTunnels
). - Itinéraires spécifiques aux caravanes (
totalAxleCount
,totalHeightMm
,totalLengthMm
,totalWidthMm
,totalWeightKg
).