L'API Routes pour le secteur automobile fournit des attributs spécialisés aux partenaires du secteur automobile qui développent des fonctionnalités de navigation embarquée. Elle étend l'API Routes standard avec des attributs adaptés à l'industrie automobile.
Contenu de la documentation de l'API Routes pour Automotive
En plus de la documentation de l'API Routes standard, l'API Routes for Automotive inclut les éléments suivants:
- Notes de version (automobile)
- Utiliser OAuth (Automotive)
- Bibliothèques clientes (Automotive)
- Documentation de référence sur REST (Automotive)
- Documentation de référence sur RPC (Automotive)
Autoriser vos requêtes
Pour autoriser les requêtes adressées à annotatePaths
, vous devez utiliser la méthode OAuth décrite ici: Utiliser OAuth (Automotive). 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, comme des tutoriels dans l'onglet "Guides".
Notez que lorsque vous utilisez les tutoriels standards de l'API Routes, les liens pointent vers la documentation de référence standard. Vous devez accéder au lien équivalent dans l'API Routes pour la documentation de référence sur le secteur automobile. Pour ce faire, ajoutez automotive/
après routes/
dans l'URL du navigateur, comme ceci: routes/automotive/
.
Obtenir de l'aide
L'API Routes pour Automotive n'étant pas disponible publiquement, nous vous demandons d'éviter de signaler des bugs dans notre Issue Tracker public. Nous avons fourni à votre équipe un composant Issue Tracker propre à l'entreprise qui permet de signaler les bugs. Adressez-vous à votre contact Google pour toute autre question.
Conventions et terminologie de Camel Case ("casse de chameau")
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 également valides.
De plus, bien qu'il soit courant de faire référence à annotatePaths
, computeRoutes
ou computeRoutesMatrix
en tant qu'API, il s'agit en réalité de méthodes personnalisées. Cependant, elles peuvent être appelées "méthodes" ou "API".
DG (disponibilité générale) et fonctionnalités expérimentales
Cette section décrit les attributs uniques de l'API Routes pour le secteur 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 les coordonnées E7 au lieu de E5):
- Éviter les ferries. Consultez
FerryInfo
- Éviter les péages. Consultez
TollInfo
- [Preview] Sélection de l'Eco Route en fonction du type de moteur. Pour en savoir plus, consultez Obtenir un itinéraire économe en carburant.
Fonctionnalités expérimentales
Les fonctionnalités suivantes sont en phase expérimentale et ne sont disponibles que pour certains clients:
Attributs de base exposés via l'API Routes
- Jeton de route utilisé comme entrée facultative. Consultez
routeToken
dans leRoute
.
Informations disponibles le long de la polyligne
- Les retards dans les embouteillages sont mesurés en minutes. Voir
IncidentType
. - Énumérations d'incidents sans texte détaillé des incidents. Voir
IncidentInfo
.
Voir PolylineDetails
.
Autres fonctionnalités
- Altitude le long du trajet. Voir
AltitudeInfo
. - Buckets à vitesse prédite sur la route (8 buckets, chacun étant compris entre 10 et 20 km/h de largeur). Voir
PredictedSpeedInfo
.
Modificateurs de routage
Vous pouvez déclencher les RouteModifiers
suivants à partir de l'API. Toutefois, les routes peuvent ne pas respecter l'objectif du modificateur, car elles sont encore en cours de développement et de test. Contactez votre représentant Google pour toute question.
- Évitez les vignettes (
avoidVignettes[]
). Disponible dans six pays: l'Autriche, la Hongrie, la Slovénie, la Slovaquie et la République tchèque. - Autoriser les routes réservées aux véhicules à occupation multiple (
hovPreference
). Cette fonctionnalité est disponible au Canada et aux États-Unis. - Évitez les tunnels (
avoidTunnels
). - Itinéraires spécifiques aux caravanes (
totalAxleCount
,totalHeightMm
,totalLengthMm
,totalWidthMm
,totalWeightKg
).