Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Sviluppatori dello Spazio economico europeo (SEE)
L'API Route Optimization espone due metodi:
OptimizeTours è un metodo sincrono che restituisce un percorso ottimizzato in
risposta a un OptimizeToursRequest. I client devono mantenere una connessione aperta all'API Route Optimization finché la richiesta non viene elaborata e viene restituito un OptimizeToursResponse o un errore.
BatchOptimizeTours è un metodo asincrono che accetta URI per uno o più OptimizeToursRequest e i messaggi OptimizeToursResponse corrispondenti, restituendo il nome della risorsa di un'operazione a lunga esecuzione (LRO) (REST, gRPC) che viene utilizzata per verificare il completamento del batch. I OptimizeToursRequest vengono elaborati in background, quindi i client mantengono una connessione aperta all'API Route Optimization solo il tempo necessario per inviare il BatchOptimizeToursRequest o per chiamare GetOperation per controllare lo stato della LRO. BatchOptimizeTours legge le richieste e scrive le risposte in
Google Cloud Storage.
Casi d'uso
OptimizeTours è utile per risolvere richieste semplici e di piccole dimensioni o per richieste con tempi di risoluzione di pochi minuti o meno. Il mantenimento di connessioni di lunga durata all'API Route Optimization aumenta il rischio di interruzione prima che possa essere restituita una soluzione.
BatchOptimizeTours può gestire richieste più grandi e richieste con tempi di risoluzione più lunghi perché non richiede una connessione a lunga durata all'API Route Optimization.
Operazioni a lunga esecuzione
Le operazioni di lunga durata vengono lette dall'API Route Optimization utilizzando il metodo GetOperation per
controllare lo stato di completamento di un batch. Le operazioni di lunga durata includono una proprietà done che
indica se l'elaborazione dell'intero batch è completata e un campo error
che segnala gli errori riscontrati durante l'elaborazione. Se done è true e
non è presente alcun error, il batch è stato completato correttamente. La presenza di un
error indica che l'elaborazione di alcuni o di tutti i batch non è riuscita.
Il ciclo di vita tipico di una richiesta BatchOptimizeTours è il seguente:
Invia un BatchOptimizeToursRequest all'API Route Optimization, che restituisce il nome della risorsa di un'operazione di lunga durata.
Esegui il sondaggio GetOperation con il nome della risorsa LRO restituito finché non vengono visualizzate le proprietà done o
error nella risposta LRO.
Se done è true e non è presente alcun errore, leggi OptimizeToursResponses
dagli URI di Google Cloud Storage specificati nella richiesta BatchOptimizeTours. Se è presente error, esamina l'errore, aggiorna i
OptimizeToursRequest di conseguenza in Google Cloud Storage e riprova in base
all'errore osservato.
Puoi inviare richieste OptimizeTours e BatchOptimizeTours in vari modi, dalla riga di comando o utilizzando una libreria client.
[null,null,["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eThe Route Optimization API offers two methods: \u003ccode\u003eOptimizeTours\u003c/code\u003e for synchronous processing of smaller, simpler requests and \u003ccode\u003eBatchOptimizeTours\u003c/code\u003e for asynchronous handling of larger, more complex requests.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eOptimizeTours\u003c/code\u003e requires an open connection until a response is received, while \u003ccode\u003eBatchOptimizeTours\u003c/code\u003e utilizes Google Cloud Storage for requests and responses, enabling background processing.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eBatchOptimizeTours\u003c/code\u003e relies on Long Running Operations (LROs) to track batch progress, which can be monitored via the \u003ccode\u003eGetOperation\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eWhen using \u003ccode\u003eBatchOptimizeTours\u003c/code\u003e, users should submit the request, poll for completion using the LRO, and retrieve results or address errors as indicated by the LRO status.\u003c/p\u003e\n"]]],[],null,["# Synchronous and asynchronous endpoints\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nThe Route Optimization API exposes two methods:\n\n- `OptimizeTours` is a *synchronous* method that returns an optimized route in response to an `OptimizeToursRequest`. Clients must maintain an open connection to the Route Optimization API until the request is processed and an `OptimizeToursResponse` or error is returned.\n- `BatchOptimizeTours` is an *asynchronous* method that accepts URIs for one or more `OptimizeToursRequest` and corresponding `OptimizeToursResponse` messages, returning the resource name of a *Long Running Operation* (LRO) ([REST](/maps/documentation/route-optimization/reference/rest/v1/projects.locations.operations#Operation), [gRPC](/maps/documentation/route-optimization/reference/rpc/google.longrunning#google.longrunning.Operations))) that is used to check for batch completion. `OptimizeToursRequest`s are processed in the background, so clients maintain an open connections to the Route Optimization API only long enough to submit the `BatchOptimizeToursRequest` or to call `GetOperation` to check LRO status. `BatchOptimizeTours` reads requests from and writes responses to [Google Cloud Storage](https://cloud.google.com/storage).\n\nUse cases\n---------\n\n`OptimizeTours` is convenient for solving small and simple requests, or for\nrequests with solving times of a few minutes or less. Maintaining long-lived\nconnections to the Route Optimization API increases risk of interruption before\na solution can be returned.\n\n`BatchOptimizeTours` can handle larger requests and requests with longer solving\ntime because it does not require a long-lived connection to the Route\nOptimization API.\n\nLong running operations\n-----------------------\n\nLROs are read from the Route Optimization API using the `GetOperation` method to\ncheck the completion status of a batch. LROs include a `done` property that\nindicates whether processing of the entire batch is complete and an `error`\nfield that reports errors encountered during processing. If `done` is true and\nno `error` is present, the batch completed successfully. The presence of an\n`error` indicates that some or all of the batch failed processing.\n| **Note:** REST `GetOperation` responses omit the `done` property if its value is false and the `error` property if no errors occurred.\n\nThe typical lifecycle of a `BatchOptimizeTours` request is as follows:\n\n1. Submit a `BatchOptimizeToursRequest` to the Route Optimization API, which returns the resource name of an LRO.\n2. Poll `GetOperation` with the returned LRO resource name until the `done` or `error` properties appear in the LRO response.\n3. If `done` is true and no error is present, read `OptimizeToursResponses` from the Google Cloud Storage URIs specified in the `BatchOptimizeTours` request. If `error` is present, inspect the error, update the `OptimizeToursRequest`s accordingly in Google Cloud Storage, and retry as appropriate depending on the observed error.\n\nYou can send `OptimizeTours` and `BatchOptimizeTours` requests in a variety of\nways, either from the command line or using a client library.\n\n[Next: Make an API Request](/maps/documentation/route-optimization/make-request)"]]
