Aide-mémoire de l'API Route Optimization

L'API Route Optimization attribue des tâches et des itinéraires à une flotte de véhicules, en les optimisant en fonction des objectifs et des contraintes que vous fournissez, tels que les périodes, la capacité des véhicules, les heures de conduite et les coûts. Vous l'appelez via REST, gRPC ou des bibliothèques clientes, et elle renvoie des séquences de visites, des attributions d'envois, des estimations de temps et des métriques d'itinéraires.

API Route Optimization : informations clés

  • Produit : API Route Optimization
  • Également appelé : GMPRO
  • 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 Route Optimization

API Route Optimization : quand l'utiliser ?

Utilisez l'API Route Optimization dans les cas suivants :

  • Vous devez attribuer des envois ou des tâches à plusieurs véhicules tout en respectant les périodes, la capacité des véhicules, les heures de conduite et les coûts.
  • Vous avez besoin de la meilleure séquence d'arrêts pour un véhicule effectuant plusieurs collectes, livraisons ou rendez-vous.
  • Vous devez réoptimiser les itinéraires actifs pour les nouvelles commandes (par exemple, l'envoi à la demande) à l'aide de injectedFirstSolutionRoutes ou injectedSolutionConstraint.
  • Vous avez besoin de jetons de route pour chaque étape d'un plan optimisé à transmettre au SDK Navigation.

Quand ne pas utiliser l'API Route Optimization ?

  • Vous avez besoin d'un suivi en temps réel de la façon dont les conducteurs exécutent le plan. L'API renvoie des polylignes planifiées, et non des itinéraires de véhicules en temps réel. Utilisez plutôt le service Fleet Engine.
  • Vous avez besoin d'une navigation détaillée dans l'application pour les conducteurs le long de l'itinéraire optimisé. Utilisez plutôt le SDK Navigation pour Android.
  • Vous avez besoin d'une navigation détaillée intégrée à l'application pour les conducteurs sur iOS le long de l'itinéraire optimisé. Utilisez plutôt le SDK Navigation pour iOS.

API Route Optimization : configuration

Packages officiels de l'API Route Optimization :

  • npm : @googlemaps/routeoptimization
  • pypi : google-maps-routeoptimization
  • go : cloud.google.com/go/maps
  • maven: com.google.maps:google-maps-routeoptimization

API Route Optimization : erreurs courantes

  • Problème : Pour les appels REST au point de terminaison OptimizeTours bloquant, le délai par défaut de 60 secondes remplace tout timeout de corps de requête supérieur à 60 secondes. Correction : définissez l'en-tête X-Server-Timeout (en secondes, sans suffixe "s") pour prolonger le délai. Les bibliothèques clientes et gRPC utilisent par défaut une valeur de 3 600 secondes. Consultez /maps/documentation/route-optimization/timeouts.
  • Problème : Les valeurs de timeout et de délai avant expiration sont limitées à 1 800 secondes. Solution : Définissez allowLargeDeadlineDespiteInterruptionRisk sur true pour autoriser jusqu'à 3 600 secondes, en acceptant un risque plus élevé d'erreurs d'interruption. Consultez /maps/documentation/route-optimization/timeouts.
  • Problème : Sans paramètres de coût (par exemple, costPerHour ou costPerKilometer), l'optimiseur traite toutes les solutions de la même manière. Correction : définissez des paramètres de coût sur les véhicules qui reflètent les coûts de votre entreprise. Consultez /maps/documentation/route-optimization/make-first-request.
  • Problème : Les requêtes authentifiées avec une clé API échouent. Chaque requête nécessite un jeton OAuth. Correction : Utilisez un jeton OAuth avec le champ d'application https://www.googleapis.com/auth/cloud-platform, par exemple via les identifiants par défaut de l'application ou un compte de service. Consultez /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token.

Ce que vous pouvez faire avec l'API Route Optimization

Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.