Endpoints síncronos e assíncronos

Desenvolvedores do Espaço Econômico Europeu (EEE)

Se o endereço de faturamento estiver no Espaço Econômico Europeu, a partir de 8 de julho de 2025, os Termos de Serviço da Plataforma Google Maps para o EEE vão se aplicar ao uso dos Serviços. A funcionalidade varia de acordo com a região. Saiba mais.

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 precisam manter uma conexão aberta com a API Route Optimization até que a solicitação seja processada e uma OptimizeToursResponse ou um erro seja retornado.
• BatchOptimizeTours é um método assíncrono que aceita URIs para um ou mais OptimizeToursRequest e mensagens OptimizeToursResponse correspondentes, retornando o nome do recurso de uma operação de longa duração (LRO, na sigla em inglês) (REST, gRPC) que é usada para verificar a conclusão do lote. Os OptimizeToursRequests são processados em segundo plano, para que os clientes mantenham uma conexão aberta com a API Route Optimization apenas o tempo suficiente para enviar o BatchOptimizeToursRequest ou chamar GetOperation para verificar o status da LRO. O BatchOptimizeTours lê solicitações e grava respostas no Google Cloud Storage.

Casos de uso

O OptimizeTours é conveniente para resolver solicitações pequenas e simples ou 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 seja retornada.

BatchOptimizeTours pode processar solicitações maiores e com tempo de resolução mais longo, 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 da 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 foi concluído e um campo error que informa erros encontrados durante o processamento. Se done for verdadeiro e nenhum error estiver presente, o lote será concluído. A presença de um error indica que o processamento de alguns ou de todos os lotes falhou.

Observação: as respostas GetOperation REST omitem a propriedade done se o valor dela for falso e a propriedade error se nenhum erro ocorrer.

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

1. Envie um BatchOptimizeToursRequest para a API Route Optimization, que retorna o nome do recurso de uma LRO.
2. Faça uma pesquisa GetOperation com o nome do recurso LRO retornado até que as propriedades done ou error apareçam na resposta da LRO.
3. Se done for verdadeiro e nenhum erro estiver presente, leia OptimizeToursResponses dos URIs do Google Cloud Storage especificados na solicitação BatchOptimizeTours. Se error estiver presente, inspecione o erro, atualize os OptimizeToursRequests de acordo com o Google Cloud Storage e tente novamente conforme necessário, dependendo do erro observado.

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

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