Die Route Optimization API stellt zwei Methoden zur Verfügung:
OptimizeTours
ist eine synchrone Methode, die eine optimierte Route in Antwort aufOptimizeToursRequest
. Die Kundschaft muss eine offene Verbindung zur Route Optimization API herstellen, bis die Anfrage verarbeitet wurde undOptimizeToursResponse
oder ein Fehler wird zurückgegeben.BatchOptimizeTours
ist eine asynchrone Methode, die URIs für einen Parameter akzeptiert. oder mehrOptimizeToursRequest
und entsprechendeOptimizeToursResponse
Nachrichten, die den Ressourcennamen eines lang laufenden Vorgangs (Long Running Operation, LRO) zurückgeben (REST, gRPC), die zur Überprüfung des Batchabschlusses verwendet wird.OptimizeToursRequest
-Daten werden im Hintergrund verarbeitet, eine offene Verbindung zur Route Optimization API, die nur so lange besteht,BatchOptimizeToursRequest
oderGetOperation
anrufen, um LRO zu prüfen Status.BatchOptimizeTours
liest Anfragen aus und schreibt Antworten in Google Cloud Storage
Anwendungsfälle
OptimizeTours
eignet sich für die Bearbeitung kleiner und einfacher Anfragen
Anfragen mit einer Bearbeitungszeit von wenigen Minuten oder weniger. Langlebig
erhöht das Risiko von Unterbrechungen vor
eine Lösung zurückgegeben werden kann.
BatchOptimizeTours
kann größere und länger dauernde Anfragen verarbeiten.
da hierfür keine langlebige Verbindung zur Route erforderlich ist.
Optimierungs-API
Lang andauernde Vorgänge
LROs werden mit der Methode GetOperation
aus der Route Optimization API gelesen, um
den Abschlussstatus eines Batches prüfen. LROs enthalten das Attribut done
, das
gibt an, ob die Verarbeitung des gesamten Batches abgeschlossen ist und ein error
Feld, das während der Verarbeitung aufgetretene Fehler meldet. Wenn done
wahr ist und
kein error
vorhanden ist, wurde der Batch erfolgreich abgeschlossen. Das Vorhandensein eines
error
gibt an, dass die Verarbeitung eines Teils oder des gesamten Batches fehlgeschlagen ist.
Der typische Lebenszyklus einer BatchOptimizeTours
-Anfrage sieht so aus:
- Senden Sie eine
BatchOptimizeToursRequest
an die Route Optimization API, die gibt den Ressourcennamen eines LRO zurück. - Fragen Sie
GetOperation
mit dem zurückgegebenen Namen der LRO-Ressource ab, bisdone
odererror
-Properties werden in der Antwort auf lange Sicht aufgeführt. - Wenn
done
„true“ ist und kein Fehler vorhanden ist, lesen SieOptimizeToursResponses
über die Google Cloud Storage-URIs, die inBatchOptimizeTours
angegeben sind Wennerror
vorhanden ist, prüfen Sie den Fehler und aktualisieren Sie denOptimizeToursRequest
entsprechend in Google Cloud Storage und wiederholen Sie den Vorgang als je nach beobachtetem Fehler angemessen ist.
Sie können OptimizeTours
- und BatchOptimizeTours
-Anfragen auf einer Vielzahl von
entweder über die Befehlszeile
oder mithilfe einer Clientbibliothek.