L'API Route Optimization espone due metodi:
OptimizeTours
è un metodo sincrono che restituisce una route ottimizzata in risposta a unOptimizeToursRequest
. I clienti devono mantenere connessione all'API Route Optimization finché la richiesta non viene elaborata viene restituito unOptimizeToursResponse
o un errore.BatchOptimizeTours
è un metodo asincrono che accetta URI per uno o piùOptimizeToursRequest
eOptimizeToursResponse
corrispondenti , restituendo il nome risorsa di un'operazione a lunga esecuzione (LRO). (REST, gRPC) utilizzato per verificare il completamento del batch. GliOptimizeToursRequest
vengono elaborati in background, quindi i client mantengono connessioni aperte all'API Route Optimization solo per il tempo necessario all'invio ilBatchOptimizeToursRequest
o per chiamareGetOperation
per controllare l'LRO .BatchOptimizeTours
legge le richieste e scrive le risposte in Google Cloud Storage:
Casi d'uso
OptimizeTours
è utile per risolvere richieste semplici e piccole o per
con tempi di risoluzione di pochi minuti o meno. Mantenimento di lunga durata
all'API Route Optimization aumenta il rischio di interruzioni
una soluzione.
BatchOptimizeTours
può gestire richieste e richieste più grandi con tempi di risoluzione
perché non richiede una connessione di lunga durata
l'API Optimization.
Operazioni a lunga esecuzione
Gli LRO vengono letti dall'API Route Optimization utilizzando il metodo GetOperation
per
Controllare lo stato di completamento di un batch. Gli LRO includono una proprietà done
che
indica se l'elaborazione dell'intero batch è completa e viene error
in cui vengono segnalati gli errori riscontrati durante l'elaborazione. Se done
è vero e
nessun error
presente, il batch è stato completato correttamente. La presenza di un
error
indica che l'elaborazione di tutto o parte del batch non è riuscita.
Il ciclo di vita tipico di una richiesta BatchOptimizeTours
è il seguente:
- Invia un
BatchOptimizeToursRequest
all'API Route Optimization, restituisce il nome risorsa di un LRO. - Sondaggio
GetOperation
con il nome della risorsa LRO restituito fino adone
o Le proprietàerror
vengono visualizzate nella risposta LRO. - Se
done
è vero e non è presente alcun errore, leggiOptimizeToursResponses
dagli URI di Google Cloud Storage specificati inBatchOptimizeTours
richiesta. Se è presenteerror
, controlla l'errore e aggiorna il valoreOptimizeToursRequest
di conseguenza in Google Cloud Storage e riprova come appropriata a seconda dell'errore osservato.
Puoi inviare richieste OptimizeTours
e BatchOptimizeTours
in diversi
tramite la riga di comando o una libreria client.