Method: projects.locations.optimizeTours

string (Duration format)

Se esse tempo limite for definido, o servidor retornará uma resposta antes que o tempo limite tenha decorrido ou que o prazo do servidor para solicitações síncronas seja atingido, o que ocorrer primeiro.

Para solicitações assíncronas, o servidor gerará uma solução (se possível) antes que o tempo limite tenha decorrido.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

object (ShipmentModel)

Modelo de envio a ser resolvido.

enum (SolvingMode)

Por padrão, o modo de resolução é DEFAULT_SOLVE (0).

enum (SearchMode)

Modo de pesquisa usado para resolver a solicitação.

object (ShipmentRoute)

Orientar o algoritmo de otimização para encontrar uma primeira solução semelhante a uma solução anterior.

O modelo é restrito quando a primeira solução é criada. Quaisquer remessas não realizadas em uma rota são implicitamente ignoradas na primeira solução, mas podem ser realizadas em soluções sucessivas.

A solução precisa satisfazer algumas suposições básicas de validade:

• Para todos os trajetos, vehicleIndex precisa estar dentro do intervalo e não ser duplicado.
• para todas as visitas, shipmentIndex e visitRequestIndex precisam estar no intervalo.
• uma remessa só pode ser referenciada em uma rota.
• a retirada de uma remessa para retirada-entrega deve ser realizada antes da entrega.
• não é possível realizar mais do que uma alternativa de retirada ou entrega de um envio.
• para todas as rotas, os tempos estão aumentando (ou seja, vehicleStartTime <= visits[0].start_time <= visits[1].start_time ... <= vehicleEndTime).
• uma remessa só pode ser realizada em um veículo permitido. Um veículo será permitido se a Shipment.allowed_vehicle_indices estiver vazia ou se o vehicleIndex estiver incluído no Shipment.allowed_vehicle_indices.

Se a solução injetada não for viável, um erro de validação não será necessariamente retornado e um erro indicando inviabilidade poderá ser retornado.

object (InjectedSolutionConstraint)

Limitar o algoritmo de otimização para encontrar uma solução final semelhante a uma anterior. Por exemplo, isso pode ser usado para congelar partes de rotas que já foram concluídas ou que estão a serem concluídas, mas não devem ser modificadas.

Se a solução injetada não for viável, um erro de validação não será necessariamente retornado, e um erro indicando a inviabilidade poderá ser retornado.

object (ShipmentRoute)

Se não estiverem vazios, os trajetos informados serão atualizados sem modificar a sequência subjacente de visitas ou tempos de viagem: apenas outros detalhes serão atualizados. Isso não resolve o modelo.

Desde 11/2020, ele preenche apenas as polilinhas de trajetos não vazios e exige que populatePolylines seja verdadeiro.

Os campos routePolyline das rotas transmitidas podem ser inconsistentes com a rota transitions.

Esse campo não pode ser usado com injectedFirstSolutionRoutes ou injectedSolutionConstraint.

Shipment.ignore e Vehicle.ignore não afetam o comportamento. As polilinhas ainda são preenchidas entre todas as visitas em todos os trajetos não vazios, independentemente de as remessas ou os veículos relacionados serem ignorados.

boolean

Se for verdadeiro:

• usa ShipmentRoute.vehicle_label em vez de vehicleIndex para corresponder a trajetos em uma solução injetada com veículos na solicitação; reutiliza o mapeamento do ShipmentRoute.vehicle_index original para o novo ShipmentRoute.vehicle_index para atualizar ConstraintRelaxation.vehicle_indices se não estiver vazio, mas o mapeamento precisa ser inequívoco (ou seja, vários ShipmentRoutes não podem compartilhar o mesmo vehicleIndex original).
• usa ShipmentRoute.Visit.shipment_label em vez de shipmentIndex para corresponder as visitas em uma solução injetada com remessas na solicitação;
• usa SkippedShipment.label em vez de SkippedShipment.index para corresponder as remessas ignoradas na solução injetada com as remessas solicitadas.

Essa interpretação se aplica aos campos injectedFirstSolutionRoutes, injectedSolutionConstraint e refreshDetailsRoutes. Ele pode ser usado quando os índices da remessa ou do veículo na solicitação tiverem mudado desde que a solução foi criada, talvez porque remessas ou veículos tenham sido removidos ou adicionados à solicitação.

Se verdadeiro, os rótulos nas seguintes categorias precisam aparecer no máximo uma vez na categoria:

• Vehicle.label na solicitação.
• Shipment.label na solicitação;
• ShipmentRoute.vehicle_label na solução injetada;
• SkippedShipment.label e ShipmentRoute.Visit.shipment_label na solução injetada (exceto pares de visita de retirada/entrega, em que shipmentLabel precisa aparecer duas vezes).

Se um vehicleLabel na solução injetada não corresponder a um veículo de solicitação, o trajeto correspondente será removido da solução com as visitas dele. Se um shipmentLabel na solução injetada não corresponder a um envio de solicitação, a visita correspondente será removida da solução. Se um SkippedShipment.label na solução injetada não corresponder a um envio de solicitação, o SkippedShipment será removido da solução.

A remoção de visitas ao trajeto ou trajetos inteiros de uma solução injetada pode afetar as restrições implícitas, o que pode levar a mudanças na solução, erros de validação ou inviabilidade.

OBSERVAÇÃO: o autor da chamada precisa garantir que cada Vehicle.label (resp. Shipment.label) identifica exclusivamente uma entidade de veículo (envio resp.) usada nas duas solicitações relevantes: a solicitação anterior que produziu o OptimizeToursResponse usado na solução injetada e a solicitação atual que inclui a solução injetada. As verificações de exclusividade descritas acima não são suficientes para garantir esse requisito.

boolean

Considere a estimativa de tráfego no cálculo dos campos ShipmentRoute, Transition.travel_duration, Visit.start_time e vehicleEndTime. na definição do campo ShipmentRoute.has_traffic_infeasibilities e no cálculo do campo OptimizeToursResponse.total_cost.

boolean

Se verdadeiro, as polilinhas serão preenchidas nas ShipmentRoutes de resposta.

boolean

Se verdadeiro, as polilinhas serão preenchidas na resposta ShipmentRoute.transitions.

boolean

Se esse valor for definido, a solicitação poderá ter um prazo de até 60 minutos (consulte https://grpc.io/blog/deadlines). Caso contrário, o prazo máximo é de apenas 30 minutos. As solicitações de longa duração têm um risco de interrupção significativamente maior, mas ainda pequeno.

boolean

Se verdadeiro, as distâncias de viagem serão calculadas usando distâncias geodésicas em vez de distâncias do Google Maps, e os tempos de viagem serão calculados usando distâncias geodésicas com uma velocidade definida por geodesicMetersPerSecond.

string

Rótulo que pode ser usado para identificar essa solicitação, informado no OptimizeToursResponse.request_label.

number

Quando useGeodesicDistances é verdadeiro, esse campo precisa ser configurado e define a velocidade aplicada para calcular os tempos de viagem. O valor precisa ser de pelo menos 1 metro/segundo.

integer

Trunca o número de erros de validação retornados. Esses erros normalmente são anexados a um payload de erro INVALID_MCC como um detalhe de erro BadRequest (https://cloud.google.com/apis/design/errors#error_details), a menos que solvingMode=VALIDATE_ONLY: consulte o campo OptimizeToursResponse.validation_errors. O padrão é 100,e o limite é 10.000.