L'API Routes est un service Web qui propose deux méthodes : Compute Routes renvoie un itinéraire entre deux lieux avec des points de cheminement intermédiaires facultatifs, et Compute Route Matrix renvoie la distance et la durée du trajet pour des combinaisons de points de départ et de destination (jusqu'à 625 éléments d'itinéraire).
API Routes : informations clés
- Produit : API Routes
- Également appelée : API Routes v2, Compute Routes, Compute Route Matrix
- Catégorie : Routes
- Plate-forme : service Web (REST)
- S'exécute sur : le serveur (code backend)
- Étape de lancement : GA
- Cycle de vie : Actif
- Présentation : Présentation de l'API Routes
- Disponibilité régionale : monde entier. Le calcul d'itinéraire pour les deux-roues, les itinéraires économes en carburant et le calcul des péages sont limités aux pays et villes compatibles. Les territoires dépendants disposant de leur propre code CLDR ne sont pas pris en charge, sauf s'ils sont listés. Pour les adresses de facturation de l'Espace économique européen (EEE), les conditions de l'EEE disponibles sur https://developers.google.com/maps/comms/eea/routes interdisent l'utilisation de descriptions ou d'étapes d'itinéraire avec une carte. (détails de la couverture)
API Routes : quand l'utiliser
Utilisez l'API Routes dans les cas suivants :
- Vous avez besoin d'un itinéraire entre un point de départ et une destination, avec des points de cheminement intermédiaires facultatifs, pour un trajet en voiture, à pied, à vélo, en deux-roues ou en transports en commun.
- Vous avez besoin des distances et des temps de trajet pour de nombreuses paires de points de départ et de destination dans une seule requête (jusqu'à 625 éléments).
- Vous avez besoin d'estimations des frais de péage (dans certaines villes), d'itinéraires économes en carburant (dans certaines régions), de polylignes tenant compte du trafic ou d'itinéraires pour les véhicules de grande taille (disponibilité limitée).
- Vous migrez une application serveur depuis l'ancienne API Directions ou l'API Distance Matrix.
Quand ne pas utiliser l'API Routes :
- Vous devez optimiser les attributions de chargement et l'ordre des arrêts pour une flotte entière de véhicules. Utilisez plutôt l'API Route Optimization.
- Vous avez besoin d'une navigation détaillée intégrée à l'application sur Android qui suit un itinéraire calculé. Utilisez plutôt le SDK Navigation pour Android.
- Vous avez besoin d'une navigation détaillée intégrée à l'application sur iOS qui suit un itinéraire calculé. Utilisez plutôt le SDK Navigation pour iOS.
API Routes : configuration
- Service à activer :
routes.googleapis.com - Authentification : clé API, OAuth 2.0, compte de service
- Premiers pas : Configurer l'API Routes
- Référence : Documentation de référence de l'API Routes
- Tarification : utilisation et facturation de l'API Routes
- Règles : Règles de l'API Routes
- Notes de version : Notes de version de l'API Routes
Packages officiels de l'API Routes :
- npm :
@googlemaps/routing - pypi :
google-maps-routing - go :
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routing
API Routes : produits associés
- Remplace : l'API Directions et l'API Distance Matrix
- Souvent utilisé avec : SDK Navigation pour Android, SDK Navigation pour iOS, API Route Optimization, API Geocoding, API Places (New)
API Routes : erreurs fréquentes
- Problème : Il n'existe pas de liste par défaut des champs renvoyés. Les requêtes sans masque de champ (en-tête
X-Goog-FieldMaskou paramètre$fields) renvoient une erreur. Correction : Envoyez toujours un masque de champ listant les champs de réponse dont vous avez besoin. Consultez /maps/documentation/routes/choose_fields. - Problème : L'utilisation du masque de champ générique (
*) en production augmente les coûts et la latence, et les coûts peuvent augmenter de manière inattendue à mesure que de nouvelles fonctionnalités avancées sont ajoutées à la réponse. Correction : Utilisez*uniquement pendant le développement. En production, ne demandez que les champs dont vous avez besoin. Consultez /maps/documentation/routes/choose_fields. - Problème : Les informations sur les péages et la consommation de carburant ne sont pas renvoyées simplement en les ajoutant au masque de champ. Depuis la disponibilité générale, elles doivent être activées explicitement. Correction : Ajoutez le tableau
extraComputations(par exemple,TOLLS,FUEL_CONSUMPTION) à la requête en plus du masque de champ. Consultez /maps/documentation/routes/migrate-routes-preview. - Problème : Compute Route Matrix autorise 625 éléments, mais seulement 100 éléments lorsque
routingPreferenceest défini surTRAFFIC_AWARE_OPTIMAL. Correction : Maintenez le nombre de points de départ x destinations à 100 ou moins lorsque vous utilisezTRAFFIC_AWARE_OPTIMAL, ou divisez la requête. Consultez /maps/documentation/routes/compute_route_matrix.
Ce que vous pouvez faire avec l'API Routes
Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.
- Renvoyez un itinéraire entre au moins deux coordonnées de latitude/longitude sous la forme d'une série de coordonnées pour chaque étape d'un itinéraire.
- Renvoie l'itinéraire entre au moins deux ensembles de coordonnées de latitude/longitude sous la forme d'une série de descriptions de manœuvres pour les étapes d'un itinéraire.
- Renvoie la distance entre chaque étape d'un itinéraire entre deux ensembles de coordonnées de latitude/longitude ou plus.
- Renvoyez le temps de trajet entre chaque étape d'un itinéraire entre deux ensembles de coordonnées de latitude/longitude ou plus.
- Renvoie une polyligne encodée entre chaque étape d'un itinéraire entre deux ensembles de coordonnées de latitude/longitude ou plus.
- Renvoyez la distance d'un itinéraire entre deux ensembles de coordonnées de latitude/longitude ou plus.
- Renvoie le temps de trajet d'un itinéraire entre deux ou plusieurs ensembles de coordonnées de latitude/longitude.
- Renvoyez une polyligne encodée pour un itinéraire entre au moins deux ensembles de coordonnées de latitude/longitude.
- Renvoyer des informations sur les péages pour un itinéraire entre au moins deux ensembles de coordonnées de latitude/longitude
- Spécifiez le mode de transport (voiture, transports en commun, marche, deux-roues) pour une demande d'itinéraire. Remarque : Dans le service Web de l'API Routes (computeRoutes), transmettez travelMode dans le corps JSON HTTP POST à l'aide de RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT ou TRUCK avec routeModifiers.vehicleInfo) et incluez l'en-tête X-Goog-FieldMask requis au lieu d'un ancien paramètre de requête GET mode. Dans la bibliothèque Routes de l'API Maps JavaScript, transmettez travelMode et les champs dans ComputeRoutesRequest.
- Spécifiez un point d'arrêt ou de passage pour une demande d'itinéraire.
- Spécifiez comment les données de trafic sont utilisées dans une requête d'itinéraire.
- Spécifiez les éléments à éviter, comme les autoroutes ou les péages, pour une demande d'itinéraire.
- Définissez des points de cheminement le long d'un itinéraire.
- Définissez des points de cheminement intermédiaires le long d'un itinéraire.
- Définissez un point par lequel un itinéraire doit passer.
- Spécifiez l'orientation du véhicule et le côté de la route pour un itinéraire.
- Optimisez l'ordre des arrêts sur votre itinéraire.
- Spécifier un itinéraire économe en carburant pour une requête d'itinéraires Preview
- Spécifiez une distance plus courte ou un itinéraire alternatif pour une requête d'itinéraires. Remarque : Dans l'API Routes, la demande d'un itinéraire de référence plus court (SHORTER_DISTANCE) est une fonctionnalité expérimentale, tandis que la demande d'itinéraires alternatifs (computeAlternativeRoutes) est en disponibilité générale.
- Renvoyez les distances pour une matrice d'itinéraires entre plusieurs points de départ et destinations.
- Renvoyez les temps de trajet pour une matrice d'itinéraires entre plusieurs points de départ et destinations.
- Renvoyez des informations sur les péages pour une matrice d'itinéraires entre plusieurs points de départ et destinations.
- Spécifiez le mode de transport (voiture, transports en commun, marche, deux-roues) pour une requête de matrice d'itinéraires. Remarque : Dans le service Web de l'API Routes (computeRouteMatrix), transmettez travelMode dans le corps JSON HTTP POST à l'aide de RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT ou TRUCK avec origins[].routeModifiers.vehicleInfo ; BICYCLE n'est pas compatible avec les matrices d'itinéraires) et incluez l'en-tête X-Goog-FieldMask requis. Dans la bibliothèque Routes de l'API Maps JavaScript, transmettez travelMode et fields sur ComputeRouteMatrixRequest.