Comparar OptimizeTours e BatchOptimizeTours

A API Route Optimization expõe dois métodos:

• OptimizeTours é um método síncrono que retorna uma rota otimizada em resposta a uma OptimizeToursRequest. Os clientes devem manter conexão com a API Route Optimization até que a solicitação seja processada e um OptimizeToursResponse ou um erro será retornado.
• BatchOptimizeTours é um método assíncrono que aceita URIs para um deles. ou mais OptimizeToursRequest e OptimizeToursResponse correspondente que retornam o nome do recurso de uma operação de longa duração (LRO, na sigla em inglês) (REST, gRPC) que são usados para verificar a conclusão do lote. OptimizeToursRequests são processados em segundo plano para que os clientes mantenham uma conexão aberta com a API Route Optimization apenas por tempo suficiente para enviar o BatchOptimizeToursRequest ou chamar GetOperation para verificar a LRO o status atual da conta. O BatchOptimizeTours lê solicitações e grava respostas em Google Cloud Storage:

Casos de uso

OptimizeTours é conveniente para resolver solicitações pequenas e simples ou para solicitações com tempos de resolução de alguns minutos ou menos. Manutenção de longa duração conexões com a API Route Optimization aumentam o risco de interrupção antes de uma solução pode ser retornada.

BatchOptimizeTours pode lidar com solicitações maiores e com resolução mais longa porque não requer uma conexão de longa duração com o API Optimization.

Operações de longa duração

As LROs são lidas da API Route Optimization usando o método GetOperation para verificam o status de conclusão de um lote. As LROs incluem uma propriedade done que indica se o processamento de todo o lote foi concluído e um error que informa erros encontrados durante o processamento. Se done for verdadeiro e não houver error presente, o lote foi concluído com sucesso. A presença de um error indica que o processamento de parte ou de todo o lote falhou.

Observação :as respostas REST GetOperation omitem a propriedade done se o valor for false e a propriedade error se não tiver ocorrido nenhum erro.

O ciclo de vida típico de uma solicitação BatchOptimizeTours é o seguinte:

1. Envie um BatchOptimizeToursRequest à API Route Optimization retorna o nome de recurso de uma LRO.
2. Pesquise GetOperation com o nome do recurso da LRO retornado até que done ou As propriedades error aparecem na resposta da LRO.
3. Se done for verdadeiro e nenhum erro estiver presente, leia OptimizeToursResponses dos URIs do Google Cloud Storage especificados em BatchOptimizeTours solicitação. Se error estiver presente, inspecione o erro, atualize o OptimizeToursRequests no Google Cloud Storage e tente novamente apropriadas dependendo do erro observado.

É possível enviar solicitações OptimizeTours e BatchOptimizeTours em várias usando a linha de comando ou uma biblioteca de cliente.

Próxima: fazer uma solicitação de API