Comparer OptimizeTours et BatchOptimizeTours

L'API Route Optimization propose deux méthodes:

  • OptimizeTours est une méthode synchrone qui renvoie un itinéraire optimisé dans en réponse à un OptimizeToursRequest. Les clients doivent maintenir un environnement à l'API Route Optimization jusqu'à ce que la requête soit traitée et une erreur OptimizeToursResponse ou une erreur est renvoyée.
  • BatchOptimizeTours est une méthode asynchrone qui accepte les URI pour un type ou plusieurs OptimizeToursRequest et les OptimizeToursResponse correspondants et renvoie le nom de ressource d'une opération de longue durée (LRO). (REST, gRPC) permet de vérifier l'exécution des lots. Les OptimizeToursRequest étant traités en arrière-plan, les clients les connexions ouvertes avec l'API Route Optimization seulement la BatchOptimizeToursRequest ou pour appeler GetOperation pour vérifier l'opération de longue durée état. BatchOptimizeTours lit les requêtes et écrit les réponses dans Google Cloud Storage :

Cas d'utilisation

OptimizeTours est pratique pour résoudre les requêtes simples et petites, ou pour avec un temps de résolution de quelques minutes ou moins. Maintenir une longue durée de vie à l'API Route Optimization augmente le risque d'interruption avant une solution peut être renvoyée.

BatchOptimizeTours peut gérer des requêtes plus importantes et des requêtes avec une résolution plus longue car il ne nécessite pas de connexion de longue durée à la route API Optimization.

Opérations de longue durée

Les opérations de longue durée sont lues à partir de l'API Route Optimization à l'aide de la méthode GetOperation pour vérifier l'état d'avancement d'un lot. Les opérations de longue durée incluent une propriété done qui indique si le traitement de l'ensemble du lot est terminé et si un error qui signale les erreurs rencontrées lors du traitement. Si done est "true" et error n'est pas présent, le lot a bien été exécuté. La présence d'un error indique que le traitement d'une partie ou de la totalité du lot a échoué.

Le cycle de vie type d'une requête BatchOptimizeTours se présente comme suit:

  1. Envoyez un BatchOptimizeToursRequest à l'API Route Optimization, renvoie le nom de ressource d'une opération de longue durée.
  2. Interrogez GetOperation avec le nom de ressource de LRO renvoyé jusqu'à ce que done ou Les propriétés error apparaissent dans la réponse de longue durée.
  3. Si done est "true" et qu'aucune erreur n'est détectée, lisez OptimizeToursResponses. à partir des URI Google Cloud Storage spécifiés dans le fichier BatchOptimizeTours requête. Si error est présent, inspectez l'erreur, mettez à jour le OptimizeToursRequest en conséquence dans Google Cloud Storage, puis réessayez en fonction de l'erreur observée.

Vous pouvez envoyer des requêtes OptimizeTours et BatchOptimizeTours de différentes façons : moyens, à partir de la ligne de commande ou à l'aide d'une bibliothèque cliente.

Étape suivante: Envoyer une requête API