Aide-mémoire de l'API Routes

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

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 : 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-FieldMask ou 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 routingPreference est défini sur TRAFFIC_AWARE_OPTIMAL. Correction : Maintenez le nombre de points de départ x destinations à 100 ou moins lorsque vous utilisez TRAFFIC_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.