OptimizeToursResponse

Resposta após a solução de um problema de otimização de rotas que contém as rotas seguidas por cada veículo, as entregas que foram ignoradas e o custo geral da solução.

Representação JSON 
{
  "routes": [
    {
      object (ShipmentRoute)
    }
  ],
  "requestLabel": string,
  "skippedShipments": [
    {
      object (SkippedShipment)
    }
  ],
  "validationErrors": [
    {
      object (OptimizeToursValidationError)
    }
  ],
  "processedRequest": {
    object (OptimizeToursRequest)
  },
  "metrics": {
    object (Metrics)
  }
}
Campos
routes[]

object (ShipmentRoute)

Rotas calculadas para cada veículo. A i-ésima rota corresponde ao i-ésimo veículo no modelo.
requestLabel

string

Cópia do OptimizeToursRequest.label, se um rótulo foi especificado na solicitação.
skippedShipments[]

object (SkippedShipment)

A lista de todas as remessas ignoradas.
validationErrors[]

object (OptimizeToursValidationError)

Lista de todos os erros de validação que conseguimos detectar de forma independente. Consulte a explicação "VÁRIOS ERROS" para a mensagem OptimizeToursValidationError. Em vez de erros, isso vai incluir avisos caso solvingMode seja DEFAULT_SOLVE.
processedRequest

object (OptimizeToursRequest)

Em alguns casos, modificamos a solicitação recebida antes de resolvê-la, ou seja, adicionamos custos. Se "solvingMode" == TRANSFORM_AND_RETURN_REQUEST, a solicitação modificada será retornada aqui.

Experimental: consulte https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request para mais detalhes.
metrics

object (Metrics)

Métricas de duração, distância e uso para esta solução.

OptimizeToursValidationError

Descreve um erro ou aviso encontrado ao validar um OptimizeToursRequest.

Representação JSON 
{
  "code": integer,
  "displayName": string,
  "fields": [
    {
      object (FieldReference)
    }
  ],
  "errorMessage": string,
  "offendingValues": string
}
Campos
code

integer

Um erro de validação é definido pelo par (code, displayName), que sempre está presente.

Os campos a seguir fornecem mais contexto sobre o erro.

VÁRIOS ERROS: quando há vários erros, o processo de validação tenta gerar vários deles. Assim como um compilador, esse é um processo imperfeito. Alguns erros de validação são "graves", ou seja, interrompem todo o processo. Esse é o caso dos erros displayName="UNSPECIFIED", entre outros. Alguns erros podem fazer com que o processo de validação pule outros erros.

ESTABILIDADE: code e displayName precisam ser muito estáveis. No entanto, novos códigos e nomes de exibição podem aparecer com o tempo, o que pode fazer com que uma determinada solicitação (inválida) gere um par diferente (code, displayName) porque o novo erro ocultou o antigo. Por exemplo, consulte "VÁRIOS ERROS".
displayName

string

O nome de exibição do erro.
fields[]

object (FieldReference)

Um contexto de erro pode envolver 0, 1 (na maioria das vezes) ou mais campos. Por exemplo, para se referir à primeira coleta do veículo nº 4 e da remessa nº 2, faça o seguinte:

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 subField {name: "pickups" index: 0} }

No entanto, a cardinalidade de fields não muda para um determinado código de erro.
errorMessage

string

String legível que descreve o erro. Há um mapeamento de um para um entre code e errorMessage (quando o código não é "UNSPECIFIED").

ESTABILIDADE: não estável. A mensagem de erro associada a um determinado code pode mudar com o tempo (esperamos que para esclarecer). Use displayName e code.
offendingValues

string

Pode conter os valores dos campos. Essa opção nem sempre está disponível. Não confie nele e use apenas para depuração manual de modelos.

FieldReference

Especifica um contexto para o erro de validação. Um FieldReference sempre se refere a um determinado campo nesse arquivo e segue a mesma estrutura hierárquica. Por exemplo, podemos especificar o elemento nº 2 de startTimeWindows do veículo nº 5 usando:

name: "vehicles" index: 5 subField { name: "endTimeWindows" index: 2 }

No entanto, omitimos entidades de nível superior, como OptimizeToursRequest ou ShipmentModel, para não sobrecarregar a mensagem.

Representação JSON 
{
  "name": string,
  "subField": {
    object (FieldReference)
  },

  // Union field index_or_key can be only one of the following:
  "index": integer,
  "key": string
  // End of list of possible types for union field index_or_key.
}
Campos
name

string

Nome do campo, por exemplo, "vehicles".
subField

object (FieldReference)

Subcampo aninhado recursivamente, se necessário.

Campo de união index_or_key.

index_or_key pode ser apenas de um dos tipos a seguir:
index

integer

Índice do campo, se repetido.
key

string

Chave se o campo for um mapa.

Métricas

Métricas gerais, agregadas em todas as rotas.

Representação JSON 
{
  "aggregatedRouteMetrics": {
    object (AggregatedMetrics)
  },
  "skippedMandatoryShipmentCount": integer,
  "usedVehicleCount": integer,
  "earliestVehicleStartTime": string,
  "latestVehicleEndTime": string,
  "costs": {
    string: number,
    ...
  },
  "totalCost": number
}
Campos
aggregatedRouteMetrics

object (AggregatedMetrics)

Agregado nas rotas. Cada métrica é a soma (ou o máximo, para cargas) de todos os campos ShipmentRoute.metrics com o mesmo nome.
skippedMandatoryShipmentCount

integer

Número de envios obrigatórios ignorados.
usedVehicleCount

integer

Número de veículos usados. Observação: se uma rota de veículo estiver vazia e Vehicle.used_if_route_is_empty for verdadeiro, o veículo será considerado usado.
earliestVehicleStartTime

string (Timestamp format)

O horário de início mais antigo para um veículo usado, calculado como o mínimo em todos os veículos usados de ShipmentRoute.vehicle_start_time.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
latestVehicleEndTime

string (Timestamp format)

O horário de término mais recente de um veículo usado, calculado como o máximo em todos os veículos usados de ShipmentRoute.vehicle_end_time.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
costs

map (key: string, value: number)

Custo da solução, detalhado por campos de solicitação relacionados a custos. As chaves são caminhos proto, relativos à entrada "OptimizeToursRequest", por exemplo, "model.shipments.pickups.cost", e os valores são o custo total gerado pelo campo de custo correspondente, agregado em toda a solução. Em outras palavras, costs["model.shipments.pickups.cost"] é a soma de todos os custos de coleta na solução. Todos os custos definidos no modelo são informados em detalhes aqui, exceto os custos relacionados a "TransitionAttributes", que são informados apenas de forma agregada a partir de 01/2022.
totalCost

number

Custo total da solução. A soma de todos os valores no mapa de custos.