Confronto tra OptimizeTour e BatchOptimizeTours

L'API Route Optimization espone due metodi:

  • OptimizeTours è un metodo sincrono che restituisce una route ottimizzata in risposta a un OptimizeToursRequest. I clienti devono mantenere connessione all'API Route Optimization finché la richiesta non viene elaborata viene restituito un OptimizeToursResponse o un errore.
  • BatchOptimizeTours è un metodo asincrono che accetta URI per uno o più OptimizeToursRequest e OptimizeToursResponse corrispondenti , restituendo il nome risorsa di un'operazione a lunga esecuzione (LRO). (REST, gRPC) utilizzato per verificare il completamento del batch. Gli OptimizeToursRequest vengono elaborati in background, quindi i client mantengono connessioni aperte all'API Route Optimization solo per il tempo necessario all'invio il BatchOptimizeToursRequest o per chiamare GetOperation 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:

  1. Invia un BatchOptimizeToursRequest all'API Route Optimization, restituisce il nome risorsa di un LRO.
  2. Sondaggio GetOperation con il nome della risorsa LRO restituito fino a done o Le proprietà error vengono visualizzate nella risposta LRO.
  3. Se done è vero e non è presente alcun errore, leggi OptimizeToursResponses dagli URI di Google Cloud Storage specificati in BatchOptimizeTours richiesta. Se è presente error, controlla l'errore e aggiorna il valore OptimizeToursRequest 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.

Passaggio successivo: effettuare una richiesta API