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
injectedFirstSolutionRoutesouinjectedSolutionConstraint. - 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
- Service à activer :
routeoptimization.googleapis.com - Authentification : OAuth 2.0, compte de service
- Premiers pas : Configurer l'API Route Optimization
- Référence : Documentation de référence de l'API Route Optimization
- Tarifs : utilisation et facturation de l'API Route Optimization
- Règles : Règles de l'API Route Optimization
- Notes de version : Notes de version de l'API Route Optimization
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 : produits associés
- Souvent utilisé avec : SDK Navigation pour Android, SDK Navigation pour iOS, service Fleet Engine, API Maps JavaScript
API Route Optimization : erreurs courantes
- Problème : Pour les appels REST au point de terminaison
OptimizeToursbloquant, le délai par défaut de 60 secondes remplace touttimeoutde corps de requête supérieur à 60 secondes. Correction : définissez l'en-têteX-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
timeoutet de délai avant expiration sont limitées à 1 800 secondes. Solution : DéfinissezallowLargeDeadlineDespiteInterruptionRisksurtruepour 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,
costPerHouroucostPerKilometer), 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.
- Renvoyez un plan de livraison à plusieurs arrêts, optimisé en fonction des contraintes d'itinéraire, de coût, d'expédition et de véhicule spécifiées.
- Renvoyez les heures de début et de fin de chaque arrêt d'un plan de livraison optimisé.
- Renvoyez les durées de trajet, de retard, de pause et d'attente entre chaque arrêt d'un plan de livraison optimisé.
- Renvoyez des informations sur la charge du véhicule à chaque arrêt d'un plan de livraison optimisé.
- Renvoyez les informations de coût pour chaque envoi dans un plan de livraison optimisé.
- Renvoyez une polyligne encodée pour l'itinéraire entre chaque arrêt d'un plan de livraison optimisé.
- Renvoyez un jeton d'itinéraire de navigation pour l'itinéraire entre chaque arrêt d'un plan de livraison optimisé.
- Renvoyez des métriques agrégées sur les expéditions, les véhicules et les coûts pour un plan de livraison optimisé.
- Spécifiez la période de début et de fin d'un plan de livraison à arrêts multiples.
- Spécifiez les heures de début et de fin de disponibilité, ainsi que les emplacements de chaque véhicule dans un plan de livraison à arrêts multiples.
- Spécifiez les coûts de temps de véhicule pour chaque véhicule dans un plan de livraison à arrêts multiples.
- Spécifiez les paramètres du modèle de coût pour un plan de livraison à arrêts multiples.
- Spécifiez des contraintes de temps pour l'enlèvement et la livraison de chaque envoi dans un plan de livraison à arrêts multiples.
- Spécifiez les attributions de véhicules pour un plan de livraison à arrêts multiples.
- Spécifiez des limites de charge pour chaque véhicule dans un plan de livraison à arrêts multiples.
- Indiquez si vous souhaitez prendre en compte les informations sur le trafic en temps réel pour un plan de livraison à arrêts multiples.
- Traitez par lot une requête d'optimisation de plan de livraison à plusieurs arrêts et écrivez la réponse dans Google Cloud Storage.
- Prévoyez du temps pour vous garer avant d'effectuer des livraisons.
- Priorisez les visites à proximité pour les effectuer les unes après les autres.
- Évitez de faire demi-tour sur un itinéraire de véhicule à arrêts multiples. Expérimental Remarque : Fonctionnalité expérimentale, soumise aux conditions et limites de la phase pré-DG.
- Optimisez vos campagnes en fonction d'objectifs prédéfinis. Expérimental Remarque : Fonctionnalité expérimentale, soumise aux conditions et limites de la phase pré-DG.
- Livrez d'abord les colis les plus lourds. Expérimental Remarque : Fonctionnalité expérimentale, soumise aux conditions et limites de la phase pré-DG.