Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Desenvolvedores do Espaço Econômico Europeu (EEE)
A API Route Optimization expõe dois métodos:
OptimizeTours é um método síncrono que retorna uma rota otimizada em resposta a um OptimizeToursRequest. Os clientes precisam manter uma conexão
aberta com a API Route Optimization até que a solicitação seja processada e
um OptimizeToursResponse ou 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) (REST, gRPC) usada para verificar a conclusão do lote. Os OptimizeToursRequest são processados em segundo plano, então os clientes mantêm uma conexão aberta com a API Route Optimization apenas pelo tempo necessário 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 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.
O BatchOptimizeTours pode processar solicitações maiores e com mais tempo de resolução porque não exige 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 os erros encontrados durante o processamento. Se done for verdadeiro e nenhum error estiver presente, o lote será concluído com sucesso. A presença de um
error indica que parte ou todo o lote não foi processado.
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.
Faça uma pesquisa de GetOperation com o nome do recurso LRO retornado até que as propriedades done ou error apareçam na resposta da LRO.
Se done for verdadeiro e não houver erros, 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 de novo
conforme apropriado, 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.
[null,null,["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eThe Route Optimization API offers two methods: \u003ccode\u003eOptimizeTours\u003c/code\u003e for synchronous processing of smaller, simpler requests and \u003ccode\u003eBatchOptimizeTours\u003c/code\u003e for asynchronous handling of larger, more complex requests.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eOptimizeTours\u003c/code\u003e requires an open connection until a response is received, while \u003ccode\u003eBatchOptimizeTours\u003c/code\u003e utilizes Google Cloud Storage for requests and responses, enabling background processing.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eBatchOptimizeTours\u003c/code\u003e relies on Long Running Operations (LROs) to track batch progress, which can be monitored via the \u003ccode\u003eGetOperation\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eWhen using \u003ccode\u003eBatchOptimizeTours\u003c/code\u003e, users should submit the request, poll for completion using the LRO, and retrieve results or address errors as indicated by the LRO status.\u003c/p\u003e\n"]]],[],null,["# Synchronous and asynchronous endpoints\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nThe Route Optimization API exposes two methods:\n\n- `OptimizeTours` is a *synchronous* method that returns an optimized route in response to an `OptimizeToursRequest`. Clients must maintain an open connection to the Route Optimization API until the request is processed and an `OptimizeToursResponse` or error is returned.\n- `BatchOptimizeTours` is an *asynchronous* method that accepts URIs for one or more `OptimizeToursRequest` and corresponding `OptimizeToursResponse` messages, returning the resource name of a *Long Running Operation* (LRO) ([REST](/maps/documentation/route-optimization/reference/rest/v1/projects.locations.operations#Operation), [gRPC](/maps/documentation/route-optimization/reference/rpc/google.longrunning#google.longrunning.Operations))) that is used to check for batch completion. `OptimizeToursRequest`s are processed in the background, so clients maintain an open connections to the Route Optimization API only long enough to submit the `BatchOptimizeToursRequest` or to call `GetOperation` to check LRO status. `BatchOptimizeTours` reads requests from and writes responses to [Google Cloud Storage](https://cloud.google.com/storage).\n\nUse cases\n---------\n\n`OptimizeTours` is convenient for solving small and simple requests, or for\nrequests with solving times of a few minutes or less. Maintaining long-lived\nconnections to the Route Optimization API increases risk of interruption before\na solution can be returned.\n\n`BatchOptimizeTours` can handle larger requests and requests with longer solving\ntime because it does not require a long-lived connection to the Route\nOptimization API.\n\nLong running operations\n-----------------------\n\nLROs are read from the Route Optimization API using the `GetOperation` method to\ncheck the completion status of a batch. LROs include a `done` property that\nindicates whether processing of the entire batch is complete and an `error`\nfield that reports errors encountered during processing. If `done` is true and\nno `error` is present, the batch completed successfully. The presence of an\n`error` indicates that some or all of the batch failed processing.\n| **Note:** REST `GetOperation` responses omit the `done` property if its value is false and the `error` property if no errors occurred.\n\nThe typical lifecycle of a `BatchOptimizeTours` request is as follows:\n\n1. Submit a `BatchOptimizeToursRequest` to the Route Optimization API, which returns the resource name of an LRO.\n2. Poll `GetOperation` with the returned LRO resource name until the `done` or `error` properties appear in the LRO response.\n3. If `done` is true and no error is present, read `OptimizeToursResponses` from the Google Cloud Storage URIs specified in the `BatchOptimizeTours` request. If `error` is present, inspect the error, update the `OptimizeToursRequest`s accordingly in Google Cloud Storage, and retry as appropriate depending on the observed error.\n\nYou can send `OptimizeTours` and `BatchOptimizeTours` requests in a variety of\nways, either from the command line or using a client library.\n\n[Next: Make an API Request](/maps/documentation/route-optimization/make-request)"]]
