A API Route Optimization expõe dois métodos:
OptimizeTours
é um método síncrono que retorna uma rota otimizada em resposta a umaOptimizeToursRequest
. Os clientes precisam manter uma conexão aberta com a API Route Optimization até que a solicitação seja processada e umOptimizeToursResponse
ou um erro seja retornado.BatchOptimizeTours
é um método assíncrono que aceita URIs para uma ou mais mensagensOptimizeToursRequest
eOptimizeToursResponse
correspondentes, retornando o nome do recurso de uma operação de longa duração (LRO, na sigla em inglês) (REST, gRPC) usada para verificar a conclusão do lote. OsOptimizeToursRequest
s são processados em segundo plano para que os clientes mantenham as conexões abertas com a API Route Optimization por tempo suficiente para enviar oBatchOptimizeToursRequest
ou chamarGetOperation
para verificar o status.BatchOptimizeTours
lê solicitações e grava respostas no 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. Manter conexões de longa duração com a API Route Optimization aumenta o risco de interrupção antes que uma solução possa ser retornada. Consulte Trabalhar com tempo limite para mais detalhes.
BatchOptimizeTours
pode processar solicitações maiores e com tempo de resolução maior porque não requer uma conexão de longa duração com a API Route Optimization.
Operações de longa duração
As LROs são lidas na API Route Optimization usando o método GetOperation
para verificar o status de conclusão de um lote. As LROs incluem uma propriedade done
que
indica se o processamento de todo o lote está concluído e um campo error
que informa os erros encontrados durante o processamento. Se done
for verdadeiro e
nenhum error
estiver presente, o lote foi concluído com sucesso. A presença de um
error
indica que ocorreu uma falha no processamento de parte ou de todo o lote.
O ciclo de vida típico de uma solicitação BatchOptimizeTours
é o seguinte:
- Envie um
BatchOptimizeToursRequest
para a API Route Optimization, que retorna o nome do recurso de uma LRO. - Pesquise
GetOperation
com o nome do recurso da LRO retornado até que as propriedadesdone
ouerror
apareçam na resposta da LRO. - Se
done
for verdadeiro e nenhum erro estiver presente, leiaOptimizeToursResponses
dos URIs do Google Cloud Storage especificados na solicitaçãoBatchOptimizeTours
. Seerror
estiver presente, inspecione o erro, atualize osOptimizeToursRequest
s de acordo no Google Cloud Storage e tente novamente conforme adequado, dependendo do erro observado.
As solicitações OptimizeTours
e BatchOptimizeTours
podem ser enviadas de várias maneiras, a partir da linha de comando ou usando uma biblioteca de cliente.