Package google.maps.routeoptimization.v1

int32

Número de envios realizados. Um par de retirada e entrega só é contado uma vez.

Duration

A duração total da viagem para uma rota ou solução.

Duration

Duração total da espera para uma rota ou solução.

Duration

Duração total do atraso de um trajeto ou uma solução.

Duration

Duração total do intervalo para uma rota ou solução.

Duration

Duração total da visita para um trajeto ou uma solução.

Duration

A duração total precisa ser igual à soma de todas as durações acima. Para rotas, também corresponde a:

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

Distância total percorrida de um trajeto ou uma solução.

map<string, VehicleLoad>

Carga máxima alcançada em toda a rota (ou solução), para cada uma das quantidades nessa rota (ou solução), calculada como o máximo em todos os Transition.vehicle_loads (ou ). ShipmentRoute.metrics.max_loads.

int32

Número de envios obrigatórios realizados.

Experimental: o comportamento ou a existência deste campo podem mudar no futuro.

double

A soma do Shipment.penalty_cost dos envios realizados.

Experimental: o comportamento ou a existência deste campo podem mudar no futuro.

string

Obrigatório. Projeto e local de destino para fazer uma chamada.

Formato:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

Se nenhum local for especificado, uma região será escolhida automaticamente.

AsyncModelConfig

Obrigatório. Informações de entrada/saída de cada modelo de compra, como caminhos de arquivo e formatos de dados.

string

Opcional. Nome do modelo definido pelo usuário, que pode ser usado como alias para acompanhar os modelos.

InputConfig

Obrigatório. Informações sobre o modelo de entrada.

OutputConfig

Obrigatório. As informações do local de saída desejado.

BreakRequest

Sequência de intervalos. Confira a mensagem BreakRequest.

FrequencyConstraint

Vários FrequencyConstraint podem ser aplicados. Todos precisam ser atendidos pelos BreakRequests deste BreakRule. Consulte FrequencyConstraint.

Timestamp

Obrigatório. Limite inferior (inclusivo) do início do intervalo.

Timestamp

Obrigatório. Limite superior (inclusivo) do início do intervalo.

Duration

Obrigatório. Duração mínima do intervalo. Precisa ser positivo.

Duration

Obrigatório. Duração mínima do intervalo para essa restrição. Não negativo. Veja a descrição de FrequencyConstraint.

Duration

Obrigatório. Extensão máxima permitida de qualquer intervalo de tempo na rota que não inclua, pelo menos parcialmente, uma pausa de duration >= min_break_duration. Precisa ser positivo.

int64

Um limite fixo que restringe a distância a no máximo max_meters. O limite não pode ser negativo.

int64

Um limite flexível que não impõe um limite máximo de distância, mas, quando violado, resulta em um custo que se soma a outros custos definidos no modelo, com a mesma unidade.

Se definido, soft_max_meters precisa ser menor que max_meters e não negativo.

double

Custo por quilômetro incorrido, aumentando até soft_max_meters, com a fórmula:

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

Esse custo não é compatível com route_distance_limit.

double

Custo por quilômetro incorrido se a distância estiver acima do limite de soft_max_meters. O custo adicional é 0 se a distância estiver abaixo do limite. Caso contrário, a fórmula usada para calcular o custo é a seguinte:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

O custo não pode ser negativo.

string

Obrigatório. URI do Google Cloud Storage.

string

Obrigatório. URI de um objeto do Google Cloud Storage no formato gs://bucket/path/to/object.

ShipmentRoute

Rotas da solução a serem injetadas. Alguns trajetos podem ser omitidos da solução original. As rotas e os envios ignorados precisam atender às proposições de validade básicas listadas para injected_first_solution_routes.

SkippedShipment

Envios ignorados da solução a ser injetada. Alguns podem ser omitidos da solução original. Consulte o campo routes.

ConstraintRelaxation

Para zero ou mais grupos de veículos, especifica quando e quanto flexibilizar as restrições. Se esse campo estiver vazio, todas as rotas de veículos não vazias serão totalmente restritas.

Relaxation

Todas as flexibilizações de restrição de visita que serão aplicadas a visitas em trajetos com veículos em vehicle_indices.

int32

Especifica os índices de veículos a que a restrição de visita relaxations se aplica. Se estiver vazio, será considerado o padrão, e os relaxations serão aplicados a todos os veículos não especificados em outros constraint_relaxations. Pode haver no máximo um padrão, ou seja, no máximo um campo de relaxamento de restrição pode estar vazio vehicle_indices. Um índice de veículo só pode ser listado uma vez, mesmo em vários constraint_relaxations.

Um índice de veículo é mapeado da mesma forma que ShipmentRoute.vehicle_index, se interpret_injected_solutions_using_labels for verdadeiro (consulte o comentário fields).

Level

O nível de flexibilização da restrição que se aplica quando as condições em ou após threshold_time E pelo menos threshold_visit_count são atendidas.

Timestamp

O horário em que a flexibilização level pode ser aplicada.

int32

O número de visitas em que a flexibilização level pode ser aplicada. Se threshold_visit_count for 0 (ou não estiver definido), o level poderá ser aplicado diretamente na partida do veículo.

Se for route.visits_size() + 1, o level só poderá ser aplicado à extremidade do veículo. Se for maior que route.visits_size() + 1, level não será aplicado a essa rota.

DataFormat

Obrigatório. O formato dos dados de entrada.

GcsSource

Um local do Google Cloud Storage. Precisa ser um único objeto (arquivo).

LatLng

As coordenadas geográficas do ponto de parada.

int32

A direção da bússola associada à direção do fluxo de tráfego. Esse valor é usado para especificar o lado da via a ser usado para embarque e desembarque. Os valores de direção podem variar de 0 a 360, em que 0 especifica uma direção para o norte, 90 especifica uma direção para o leste e assim por diante.

string

Obrigatório. Segmente o projeto ou local para fazer uma chamada.

Formato:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

Se nenhum local for especificado, uma região será escolhida automaticamente.

Duration

Se esse tempo limite for definido, o servidor vai retornar uma resposta antes que o período de tempo limite termine ou que o prazo do servidor para solicitações síncronas seja atingido, o que acontecer primeiro.

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

ShipmentModel

Modelo de envio a ser resolvido.

SolvingMode

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

SearchMode

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

ShipmentRoute

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

O modelo é restrito quando a primeira solução é criada. As entregas 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 atender a algumas proposições básicas de validade:

• Para todas as rotas, vehicle_index precisa estar no intervalo e não pode ser duplicado.
• Para todas as visitas, shipment_index e visit_request_index precisam estar no intervalo.
• uma remessa só pode ser referenciada em um trajeto.
• A retirada de uma remessa de retirada e entrega precisa ser feita antes da entrega.
• não é possível realizar mais de uma alternativa de retirada ou entrega de um envio.
• para todas as rotas, os tempos estão aumentando (ou seja, vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• um envio só pode ser feito em um veículo permitido. Um veículo é permitido se Shipment.allowed_vehicle_indices estiver vazio ou se o vehicle_index dele estiver incluído em Shipment.allowed_vehicle_indices.

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

InjectedSolutionConstraint

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

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

ShipmentRoute

Se não estiver vazio, as rotas fornecidas serão atualizadas sem modificar a sequência de visitas ou os tempos de viagem. Apenas outros detalhes serão atualizados. Isso não resolve o modelo.

Desde 11/2020, isso só preenche as polilinhas de rotas não vazias e exige que populate_polylines seja verdadeiro.

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

Esse campo não pode ser usado com injected_first_solution_routes ou injected_solution_constraint.

Shipment.ignore e Vehicle.ignore não têm efeito no comportamento. As polilinhas ainda são preenchidas entre todas as visitas em todas as rotas não vazias, independentemente de os envios ou veículos relacionados serem ignorados.

bool

Se for verdade:

• usa ShipmentRoute.vehicle_label em vez de vehicle_index para corresponder rotas 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 vehicle_index original).
• usa ShipmentRoute.Visit.shipment_label em vez de shipment_index para corresponder visitas em uma solução injetada com envios na solicitação;
• usa SkippedShipment.label em vez de SkippedShipment.index para corresponder aos envios ignorados na solução injetada com os envios da solicitação.

Essa interpretação se aplica aos campos injected_first_solution_routes, injected_solution_constraint e refresh_details_routes. Ele pode ser usado quando os índices de envio ou de veículo na solicitação mudaram desde que a solução foi criada, talvez porque envios ou veículos foram removidos ou adicionados à solicitação.

Se for verdadeiro, os rótulos nas seguintes categorias vão aparecer no máximo uma vez em cada 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 visitas de coleta/entrega, em que shipment_label precisa aparecer duas vezes.

Se um vehicle_label na solução injetada não corresponder a um veículo de solicitação, a rota correspondente será removida da solução junto com as visitas. Se um shipment_label na solução injetada não corresponder a um envio de pedido, 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.

Remover visitas ou rotas inteiras 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 caller precisa garantir que cada Vehicle.label (resp. Shipment.label) identifica de forma exclusiva um veículo (ou remessa) usado 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.

bool

Considere a estimativa de tráfego ao calcular os campos ShipmentRoute Transition.travel_duration, Visit.start_time e vehicle_end_time, ao definir o campo ShipmentRoute.has_traffic_infeasibilities e ao calcular o campo OptimizeToursResponse.total_cost.

bool

Se for "true", as polilinhas serão preenchidas nas respostas ShipmentRoutes.

bool

Se for "true", as polilinhas e os tokens de rota serão preenchidos na resposta ShipmentRoute.transitions.

bool

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

bool

Se for "true", 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 geodesic_meters_per_second.

string

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

double

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

int32

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

ShipmentRoute

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

string

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

SkippedShipment

A lista de todas as remessas ignoradas.

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 solving_mode seja DEFAULT_SOLVE.

OptimizeToursRequest

Em alguns casos, modificamos a solicitação recebida antes de resolvê-la, ou seja, adicionamos custos. Se solving_mode == 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

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

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.

int32

Número de envios obrigatórios ignorados.

int32

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.

Timestamp

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.

Timestamp

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.

map<string, double>

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.

double

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

string

Obrigatório. Segmente o projeto ou local para fazer uma chamada.

Formato:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

Se nenhum local for especificado, uma região será escolhida automaticamente.

Uri

Obrigatório. O URI do objeto do Cloud Storage que contém o OptimizeToursRequest.

Uri

Obrigatório. O URI do objeto do Cloud Storage que vai conter o OptimizeToursResponse.

Uri

Opcional. O URI do objeto do Cloud Storage que contém o OptimizeToursResponse codificado como JSON ou textproto. Se o objeto foi codificado como JSON, a extensão do nome do objeto será .json. Se o objeto foi codificado como textproto, a extensão do nome dele será .txtpb.

O crc32_checksum do recurso pode ser usado para verificar se o conteúdo dele não foi modificado.

int32

Um erro de validação é definido pelo par (code, display_name), 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 display_name="UNSPECIFIED", entre outros. Alguns erros podem fazer com que o processo de validação pule outros erros.

ESTABILIDADE: code e display_name 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, display_name) porque o novo erro ocultou o antigo. Por exemplo, consulte "VÁRIOS ERROS".

string

O nome de exibição do erro.

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 sub_field {name: "pickups" index: 0} }

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

string

String legível que descreve o erro. Há um mapeamento de um para um entre code e error_message (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 display_name e code.

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.

string

Nome do campo, por exemplo, "vehicles".

FieldReference

Subcampo aninhado recursivamente, se necessário.

int32

Índice do campo, se repetido.

string

Chave se o campo for um mapa.

DataFormat

Obrigatório. O formato dos dados de saída.

GcsDestination

O local do Google Cloud Storage em que a saída será gravada.

bool

Especifica se é preciso evitar vias com pedágio quando possível. A preferência será dada a trajetos sem pedágios. Válido apenas para modos de viagem motorizados.

bool

Especifica se é necessário evitar rodovias quando possível. A preferência será dada a trajetos que não incluem rodovias. Válido apenas para modos de viagem motorizados.

bool

Especifica se é necessário evitar balsas quando possível. A preferência será dada a trajetos que não incluem viagens de balsa. Válido apenas para modos de viagem motorizados.

bool

Opcional. Especifica se é preciso evitar a navegação em ambientes internos quando possível. A preferência será dada a rotas que não contêm navegação interna. Aplicável apenas ao modo de viagem WALKING.

string

O nome de exibição da remessa definido pelo usuário. Ele pode ter até 63 caracteres e usar caracteres UTF-8.

VisitRequest

Conjunto de alternativas de retirada associadas ao envio. Se não for especificado, o veículo só precisará visitar um local correspondente às entregas.

VisitRequest

Conjunto de alternativas de entrega associadas ao envio. Se não for especificado, o veículo só precisará visitar um local correspondente às coletas.

map<string, Load>

Demandas de carga do frete (por exemplo, peso, volume, número de paletes etc.). As chaves no mapa precisam ser identificadores que descrevem o tipo da carga correspondente, idealmente incluindo também as unidades. Por exemplo: "weight_kg", "volume_gallons", "pallet_count&quot etc. Se uma determinada chave não aparecer no mapa, a carga correspondente será considerada nula.

int32

O conjunto de veículos que podem fazer essa entrega. Se estiver vazio, todos os veículos poderão realizar a ação. Os veículos são fornecidos pelo índice deles na lista vehicles do ShipmentModel.

double

Especifica o custo incorrido quando esta remessa é entregue por cada veículo. Se especificado, ele precisa ter UMA das seguintes opções:

• o mesmo número de elementos que costs_per_vehicle_indices. costs_per_vehicle[i] corresponde ao veículo costs_per_vehicle_indices[i] do modelo.
• o mesmo número de elementos que há veículos no modelo. O elemento i-ésimo corresponde ao veículo nº i do modelo.

Esses custos precisam estar na mesma unidade que penalty_cost e não podem ser negativos. Deixe esse campo em branco se não houver custos desse tipo.

int32

Índices dos veículos a que costs_per_vehicle se aplica. Se não estiver vazio, precisará ter o mesmo número de elementos que costs_per_vehicle. Um índice de veículo não pode ser especificado mais de uma vez. Se um veículo for excluído de costs_per_vehicle_indices, o custo dele será zero.

Duration

Especifica o tempo máximo absoluto de desvio em comparação com o caminho mais curto da coleta até a entrega. Se especificado, ele precisa ser não negativo, e o frete precisa conter pelo menos uma coleta e uma entrega.

Por exemplo, seja t o menor tempo necessário para ir da alternativa de retirada selecionada diretamente para a alternativa de entrega selecionada. Em seguida, a configuração pickup_to_delivery_absolute_detour_limit impõe:

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

Se os limites relativos e absolutos forem especificados no mesmo frete, o limite mais restritivo será usado para cada par possível de retirada/entrega. Desde outubro de 2017, os desvios só são aceitos quando as durações das viagens não dependem de veículos.

Duration

Especifica a duração máxima desde o início da coleta até o início da entrega de uma remessa. Se especificado, ele precisa ser não negativo, e o frete precisa conter pelo menos uma coleta e uma entrega. Isso não depende de quais alternativas são selecionadas para retirada e entrega, nem da velocidade do veículo. Isso pode ser especificado junto com as restrições máximas de desvio: a solução vai respeitar as duas especificações.

string

String não vazia que especifica um "tipo" para este frete. Esse recurso pode ser usado para definir incompatibilidades ou requisitos entre shipment_types (consulte shipment_type_incompatibilities e shipment_type_requirements em ShipmentModel).

Diferente de visit_types, que é especificado para uma única visita: todas as retiradas/entregas pertencentes ao mesmo envio compartilham o mesmo shipment_type.

string

Especifica um rótulo para este envio. Esse rótulo é informado na resposta no shipment_label do ShipmentRoute.Visit correspondente.

bool

Se for verdadeiro, ignore este envio, mas não aplique um penalty_cost.

Ignorar um envio resulta em um erro de validação quando há shipment_type_requirements no modelo.

É permitido ignorar uma entrega feita em injected_first_solution_routes ou injected_solution_constraint. O solucionador remove as visitas de coleta/entrega relacionadas da rota em execução. precedence_rules que fazem referência a envios ignorados também serão ignorados.

double

Se o envio não for concluído, essa penalidade será adicionada ao custo geral dos trajetos. Uma remessa é considerada concluída se uma das alternativas de retirada e entrega for visitada. O custo pode ser expresso na mesma unidade usada para todos os outros campos relacionados a custos no modelo e precisa ser positivo.

IMPORTANTE: se essa penalidade não for especificada, ela será considerada infinita, ou seja, o envio precisa ser concluído.

double

Especifica o tempo máximo de desvio relativo em comparação com o caminho mais curto da coleta até a entrega. Se especificado, ele precisa ser não negativo, e o frete precisa conter pelo menos uma coleta e uma entrega.

Por exemplo, seja t o menor tempo necessário para ir da alternativa de retirada selecionada diretamente para a alternativa de entrega selecionada. Em seguida, a configuração pickup_to_delivery_relative_detour_limit impõe:

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

Se os limites relativos e absolutos forem especificados no mesmo frete, o limite mais restritivo será usado para cada par possível de retirada/entrega. Desde outubro de 2017, os desvios só são aceitos quando as durações das viagens não dependem de veículos.

int64

A quantidade em que a carga do veículo que realiza a visita correspondente vai variar. Como é um número inteiro, recomendamos que os usuários escolham uma unidade adequada para evitar perda de precisão. Precisa ser ≥ 0.

LatLng

A geolocalização em que o veículo chega ao realizar esse VisitRequest. Se o modelo de frete tiver matrizes de distância de duração, arrival_location não poderá ser especificado.

Waypoint

O ponto de parada em que o veículo chega ao realizar este VisitRequest. Se o modelo de frete tiver matrizes de distância de duração, arrival_waypoint não poderá ser especificado.

LatLng

A geolocalização de onde o veículo sai após concluir este VisitRequest. Pode ser omitido se for igual a arrival_location. Se o modelo de frete tiver matrizes de distância de duração, departure_location não poderá ser especificado.

Waypoint

O ponto de parada em que o veículo sai após concluir este VisitRequest. Pode ser omitido se for igual a arrival_waypoint. Se o modelo de frete tiver matrizes de distância de duração, departure_waypoint não poderá ser especificado.

string

Especifica tags anexadas à solicitação de visita. Não é permitido usar strings vazias ou duplicadas.

TimeWindow

Intervalos de tempo que restringem o horário de chegada em uma visita. Um veículo pode sair fora da janela de tempo de chegada. Ou seja, o horário de chegada e a duração não precisam estar dentro de uma janela de tempo. Isso pode resultar em tempo de espera se o veículo chegar antes de TimeWindow.start_time.

A ausência de TimeWindow significa que o veículo pode fazer essa visita a qualquer momento.

As janelas de tempo não podem se sobrepor ou ser adjacentes umas às outras e precisam estar em ordem crescente.

cost_per_hour_after_soft_end_time e soft_end_time só podem ser definidos se houver um único período.

Duration

Duração da visita, ou seja, tempo gasto pelo veículo entre a chegada e a partida (a ser adicionado ao possível tempo de espera; consulte time_windows).

double

Custo para atender a essa solicitação de visita em um trajeto de veículo. Isso pode ser usado para pagar custos diferentes para cada retirada ou entrega alternativa de uma remessa. Esse custo precisa estar na mesma unidade que Shipment.penalty_cost e não pode ser negativo.

map<string, Load>

Carrega as demandas desta solicitação de visita. É igual ao campo Shipment.load_demands, mas se aplica apenas a este VisitRequest, em vez de todo o Shipment. As demandas listadas aqui são adicionadas às demandas listadas em Shipment.load_demands.

string

Especifica os tipos de visita. Isso pode ser usado para alocar o tempo extra necessário para um veículo concluir essa visita (consulte Vehicle.extra_visit_duration_for_visit_type).

Um tipo só pode aparecer uma vez.

string

Especifica um rótulo para este VisitRequest. Esse rótulo é informado na resposta como visit_label no ShipmentRoute.Visit correspondente.

bool

Especifica se retornos devem ser evitados em trajetos de carro nesse local. A prevenção de retornos é o melhor esforço possível, mas não é garantida. Este é um recurso experimental, e o comportamento dele está sujeito a mudanças.

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

Shipment

Conjunto de envios que precisam ser realizados no modelo.

Vehicle

Conjunto de veículos que podem ser usados para realizar visitas.

Objective

O conjunto de objetivos para esse modelo, que vamos transformar em custos. Se não estiver vazio, o modelo de entrada não poderá ter custo. Para receber a solicitação modificada, use solving_mode = TRANSFORM_AND_RETURN_REQUEST. Nesse caso, a solicitação não será resolvida. Consulte a documentação correspondente.

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

Timestamp

Horário de início e término global do modelo: nenhum horário fora desse intervalo pode ser considerado válido.

O período do modelo precisa ser inferior a um ano, ou seja, global_end_time e global_start_time precisam estar dentro de 31.536. 000 segundos um do outro.

Ao usar campos cost_per_*hour, talvez seja interessante definir essa janela para um intervalo menor e aumentar a performance. Por exemplo, se você modelar um único dia, defina os limites globais de tempo para esse dia. Se não for definido, 00:00:00 UTC, 1º de janeiro de 1970 (ou seja, segundos: 0, nanos: 0) será usado como padrão.

Timestamp

Se não for definido, será usado 00:00:00 UTC, 1º de janeiro de 1971 (ou seja, segundos: 31536000, nanos: 0) como padrão.

double

A "duração global" do plano geral é a diferença entre o horário de início efetivo mais cedo e o horário de término efetivo mais tarde de todos os veículos. Os usuários podem atribuir um custo por hora a essa quantidade para tentar otimizar a conclusão mais rápida do trabalho, por exemplo. Esse custo precisa estar na mesma unidade que Shipment.penalty_cost.

DurationDistanceMatrix

Especifica as matrizes de duração e distância usadas no modelo. Se esse campo estiver vazio, o Google Maps ou as distâncias geodésicas serão usados, dependendo do valor do campo use_geodesic_distances. Se não estiver vazio, use_geodesic_distances não poderá ser verdadeiro, e nem duration_distance_matrix_src_tags nem duration_distance_matrix_dst_tags poderão estar vazios.

Exemplos de uso:

• Há dois locais: locA e locB.
• Um veículo que começa e termina o trajeto em locA.
• 1 solicitação de visita para retirada em locB.

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• Há três locais: locA, locB e locC.
• Um veículo que começa o trajeto em locA e termina em locB, usando a matriz "fast".
• Um veículo que começa e termina o trajeto em locB, usando a matriz "slow".
• Um veículo que começa e termina o trajeto em locB, usando a matriz "fast".
• 1 solicitação de visita para retirada em locC.

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

Tags que definem as fontes das matrizes de duração e distância. duration_distance_matrices(i).rows(j) define durações e distâncias de visitas com a tag duration_distance_matrix_src_tags(j) para outras visitas na matriz i.

As tags correspondem a VisitRequest.tags ou Vehicle.start_tags. Um determinado VisitRequest ou Vehicle precisa corresponder exatamente a uma tag neste campo. As tags de origem, destino e matriz de um Vehicle podem ser iguais, assim como as tags de origem e destino de um VisitRequest. Todas as tags precisam ser diferentes e não podem ser strings vazias. Se esse campo não estiver vazio, duration_distance_matrices também não poderá estar.

string

Tags que definem os destinos das matrizes de duração e distância; duration_distance_matrices(i).rows(j).durations(k) (respectivamente. duration_distance_matrices(i).rows(j).meters(k)) define a duração (ou a distância) da viagem de visitas com a tag duration_distance_matrix_src_tags(j) para visitas com a tag duration_distance_matrix_dst_tags(k) na matriz i.

As tags correspondem a VisitRequest.tags ou Vehicle.start_tags. Um determinado VisitRequest ou Vehicle precisa corresponder exatamente a uma tag neste campo. As tags de origem, destino e matriz de um Vehicle podem ser iguais, assim como as tags de origem e destino de um VisitRequest. Todas as tags precisam ser diferentes e não podem ser strings vazias. Se esse campo não estiver vazio, duration_distance_matrices também não poderá estar.

TransitionAttributes

Atributos de transição adicionados ao modelo.

ShipmentTypeIncompatibility

Conjuntos de shipment_types incompatíveis (consulte ShipmentTypeIncompatibility).

ShipmentTypeRequirement

Conjuntos de requisitos shipment_type (consulte ShipmentTypeRequirement).

PrecedenceRule

Conjunto de regras de precedência que precisam ser aplicadas no modelo.

IMPORTANTE: o uso de regras de precedência limita o tamanho do problema que pode ser otimizado. As solicitações que usam regras de precedência e incluem muitos envios podem ser rejeitadas.

int32

Restringe o número máximo de veículos ativos. Um veículo está ativo se a rota dele realizar pelo menos uma entrega. Isso pode ser usado para limitar o número de rotas quando há menos motoristas do que veículos e a frota é heterogênea. Em seguida, a otimização seleciona o melhor subconjunto de veículos para usar. Precisa ser estritamente positivo.

Row

Especifica as linhas da matriz de duração e distância. Ele precisa ter o mesmo número de elementos que ShipmentModel.duration_distance_matrix_src_tags.

string

Tag que define a quais veículos essa matriz de duração e distância se aplica. Se estiver vazio, isso se aplica a todos os veículos, e só pode haver uma única matriz.

Cada início de veículo precisa corresponder a exatamente uma matriz. Ou seja, exatamente um campo start_tags precisa corresponder ao vehicle_start_tag de uma matriz (e somente dessa matriz).

Todas as matrizes precisam ter um vehicle_start_tag diferente.

Duration

Valores de duração para uma determinada linha. Ele precisa ter o mesmo número de elementos que ShipmentModel.duration_distance_matrix_dst_tags.

double

Valores de distância para uma determinada linha. Se não houver custos ou restrições relacionados a distâncias no modelo, deixe em branco. Caso contrário, ele precisa ter tantos elementos quanto durations.

Type

O tipo de objetivo.

double

Quanto esse objetivo deve contar em relação aos outros. Pode ser qualquer número não negativo. Os pesos não precisam somar 1. Os pesos têm como padrão 1,0.

bool

Indica se o evento "first" é uma entrega.

bool

Indica se o evento "segundo" é uma entrega.

Duration

O deslocamento entre o primeiro e o segundo evento. Ele pode ser negativo.

int32

Índice de envio do evento "first". Este campo precisa ser especificado.

int32

Índice de envio do segundo evento. Este campo precisa ser especificado.

int32

Veículo que está fazendo o trajeto, identificado pelo índice na ShipmentModel de origem.

string

Rótulo do veículo que está fazendo essa rota, igual a ShipmentModel.vehicles(vehicle_index).label, se especificado.

Timestamp

Horário em que o veículo inicia o trajeto.

Timestamp

Hora em que o veículo termina o trajeto.

Visit

Sequência ordenada de visitas que representam um trajeto. "visits[i]" é a i-ésima visita no trajeto. Se esse campo estiver vazio, o veículo será considerado como não utilizado.

Transition

Lista ordenada de transições para a rota.

bool

Quando OptimizeToursRequest.consider_road_traffic é definido como "true", esse campo indica que as inconsistências nos horários das rotas são previstas usando estimativas de duração da viagem com base no trânsito. Pode não haver tempo suficiente para concluir a viagem ajustada ao trânsito, atrasos e pausas entre as visitas, antes da primeira visita ou depois da última, sem violar as janelas de tempo de visita e do veículo. Por exemplo,

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

A chegada em next_visit provavelmente vai acontecer mais tarde do que a janela de tempo atual devido ao aumento da estimativa de tempo de viagem travel_duration(previous_visit, next_visit) por causa do trânsito. Além disso, uma pausa pode ser forçada a se sobrepor a uma visita devido a um aumento nas estimativas de tempo de viagem e restrições de janela de tempo de visita ou pausa.

EncodedPolyline

A representação da polilinha codificada do trajeto. Esse campo só será preenchido se OptimizeToursRequest.populate_polylines estiver definido como "true".

Break

Intervalos programados para o veículo que está fazendo esse trajeto. A sequência breaks representa intervalos de tempo, cada um começando no start_time correspondente e durando duration segundos.

AggregatedMetrics

Métricas de duração, distância e carga para essa rota. Os campos de AggregatedMetrics são somados em todos os ShipmentRoute.transitions ou ShipmentRoute.visits, dependendo do contexto.

VehicleFullness

Campo VehicleFullness para calcular a proximidade das métricas limitadas aos respectivos limites de veículos. Os campos são proporções entre um campo de métricas limitado (por exemplo, AggregatedMetrics.travel_distance_meters) e o limite relacionado do veículo (por exemplo, Vehicle.route_distance_limit).

Experimental: o comportamento ou a existência deste campo podem mudar no futuro.

map<string, double>

Custo do trajeto, detalhado por campos de solicitação relacionados a custos. As chaves são caminhos de proto, relativos ao OptimizeToursRequest de entrada, por exemplo, "model.shipments.pickups.cost", e os valores são o custo total gerado pelo campo de custo correspondente, agregado em toda a rota. Em outras palavras, costs["model.shipments.pickups.cost"] é a soma de todos os custos de coleta ao longo do trajeto. 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.

double

Custo total do trajeto. A soma de todos os custos no mapa de custos.

Timestamp

Horário de início de um intervalo.

Duration

Duração de uma pausa.

string

String que representa pontos codificados da polilinha.

Duration

Duração da viagem durante essa transição.

double

Distância percorrida durante a transição.

bool

Quando o tráfego é solicitado via OptimizeToursRequest.consider_road_traffic e as informações de trânsito não podem ser recuperadas para um Transition, esse booleano é definido como verdadeiro. Isso pode ser temporário (um problema raro nos servidores de trânsito em tempo real) ou permanente (não há dados para esse local).

Duration

Soma das durações de atraso aplicadas a essa transição. Se houver, o atraso começa exatamente delay_duration segundos antes do próximo evento (visita ou fim da viagem). Consulte os TransitionAttributes.delay.

Duration

Soma da duração dos intervalos que ocorrem durante essa transição, se houver. Os detalhes sobre o horário de início e a duração de cada intervalo são armazenados em ShipmentRoute.breaks.

Duration

Tempo gasto esperando durante essa transição. A duração da espera corresponde ao tempo ocioso e não inclui o tempo de intervalo. Além disso, esse tempo de espera pode ser dividido em vários intervalos não contínuos.

Duration

Duração total da transição, fornecida para conveniência. É igual a:

• próxima visita start_time (ou vehicle_end_time se for a última transição) - start_time desta transição;
• se ShipmentRoute.has_traffic_infeasibilities for "false", o seguinte também será válido: "total_duration = travel_duration + delay_duration"
• break_duration + wait_duration`.

Timestamp

Horário de início dessa transição.

EncodedPolyline

A representação da polilinha codificada do trajeto seguido durante a transição. Esse campo só será preenchido se populate_transition_polylines estiver definido como "true".

string

Apenas saída. Um token opaco que pode ser transmitido ao SDK Navigation para reconstruir a rota durante a navegação e, em caso de novo trajeto, respeitar a intenção original quando a rota foi criada. Trate esse token como um blob opaco. Não compare o valor dele em várias solicitações, porque ele pode mudar mesmo que o serviço retorne exatamente a mesma rota. Esse campo só será preenchido se populate_transition_polylines estiver definido como "true".

map<string, VehicleLoad>

Cargas de veículos durante essa transição, para cada tipo que aparece no Vehicle.load_limits do veículo ou que tem Shipment.load_demands diferente de zero em algum frete realizado nessa rota.

As cargas durante a primeira transição são as cargas iniciais do trajeto do veículo. Depois de cada visita, os load_demands dela são adicionados ou subtraídos para receber as cargas da próxima transição, dependendo se a visita foi uma coleta ou uma entrega.

int64

A quantidade de carga no veículo para o tipo especificado. A unidade de carga geralmente é indicada pelo tipo. Consulte Transition.vehicle_loads.

int32

Índice do campo shipments no ShipmentModel de origem.

bool

Se for verdadeiro, a visita vai corresponder a uma retirada de um Shipment. Caso contrário, corresponde a uma entrega.

int32

Índice de VisitRequest no campo de retirada ou entrega do Shipment (consulte is_pickup).

Timestamp

Horário em que a visita começa. O veículo pode chegar antes desse horário no local da visita. Os horários são consistentes com o ShipmentModel.

map<string, Load>

Demanda total de carga de visitas como a soma da solicitação de envio e de visita load_demands. Os valores são negativos se a visita for uma entrega. As demandas são informadas para os mesmos tipos que o Transition.loads (consulte este campo).

Duration

Tempo extra de desvio devido às entregas visitadas na rota antes da visita e ao possível tempo de espera induzido pelas janelas de tempo. Se a visita for uma entrega, o desvio será calculado com base na visita de coleta correspondente e será igual a:

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

Caso contrário, ele será calculado com base no start_location do veículo e será igual a:

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

Cópia do Shipment.label correspondente, se especificado no Shipment.

string

Cópia do VisitRequest.label correspondente, se especificado no VisitRequest.

int32

Um token opaco que representa informações sobre um local de visita.

Esse campo pode ser preenchido nas visitas das rotas de resultado quando VisitRequest.avoid_u_turns foi definido como verdadeiro para essa visita ou se ShipmentModel.avoid_u_turns foi definido como verdadeiro na solicitação OptimizeToursRequest.

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

string

Lista de tipos incompatíveis. Dois envios com shipment_types diferentes entre os listados são "incompatíveis".

IncompatibilityMode

Modo aplicado à incompatibilidade.

string

Lista de tipos de frete alternativos exigidos pelo dependent_shipment_types.

string

Todas as remessas com um tipo no campo dependent_shipment_types exigem que pelo menos uma remessa do tipo required_shipment_type_alternatives seja visitada no mesmo trajeto.

OBSERVAÇÃO: não são permitidas cadeias de requisitos em que um shipment_type depende de si mesmo.

RequirementMode

Modo aplicado ao requisito.

int32

O índice corresponde ao índice da remessa no ShipmentModel de origem.

string

Cópia do Shipment.label correspondente, se especificado no Shipment.

Reason

Uma lista de motivos que explicam por que o envio foi ignorado. Consulte o comentário acima Reason. Se não for possível entender por que um envio foi ignorado, os motivos não serão definidos.

double

Esta é uma cópia do Shipment.penalty_cost, incluída aqui para facilitar a visualização da gravidade de um envio ignorado.

Experimental: o comportamento ou a existência deste campo podem mudar no futuro.

double

É a proporção estimada de veículos que não podem fazer essa entrega por pelo menos um dos motivos abaixo. Observação: isso só é preenchido quando os motivos envolvem um veículo.

Experimental: o comportamento ou a existência deste campo podem mudar no futuro.

Code

Consulte os comentários do código.

int32

Igual a example_vehicle_index, mas fornecemos a lista de vários veículos identificados. Esta lista não é necessariamente completa. Isso só será preenchido se [fill_example_vehicle_indices_in_skipped_reasons][] for verdadeiro.

Experimental: o comportamento ou a existência deste campo podem mudar no futuro.

string

Se o código do motivo for DEMAND_EXCEEDS_VEHICLE_CAPACITY, documente um tipo de capacidade que foi excedido.

int32

Se o motivo estiver relacionado a uma incompatibilidade entre o veículo e a entrega, esse campo vai fornecer o índice de um veículo relevante.

Timestamp

O horário de início do período rígido. Se não for especificado, será definido como ShipmentModel.global_start_time.

Timestamp

O horário de término do período fixo. Se não for especificado, será definido como ShipmentModel.global_end_time.

Timestamp

O horário de início gradual do período.

Timestamp

O horário de término flexível do período.

double

Um custo por hora adicionado a outros custos no modelo se o evento ocorrer antes de soft_start_time, calculado como:

   max(0, soft_start_time - t.seconds)
                          * cost_per_hour_before_soft_start_time / 3600,
t being the time of the event.

Esse custo precisa ser positivo, e o campo só pode ser definido se soft_start_time tiver sido definido.

double

Um custo por hora adicionado a outros custos no modelo se o evento ocorrer após soft_end_time, calculado como:

   max(0, t.seconds - soft_end_time.seconds)
                    * cost_per_hour_after_soft_end_time / 3600,
t being the time of the event.

Esse custo precisa ser positivo, e o campo só pode ser definido se soft_end_time tiver sido definido.

string

Tags que definem o conjunto de transições (origem -> destino) a que esses atributos se aplicam.

Uma visita à origem ou um início de veículo corresponderá se o VisitRequest.tags ou Vehicle.start_tags contiver src_tag ou não contiver excluded_src_tag (dependendo de qual desses dois campos não está vazio).

string

Consulte src_tag. Exatamente um entre src_tag e excluded_src_tag não pode estar vazio.

string

Uma visita ao destino ou um fim de viagem de veículo correspondem se o VisitRequest.tags ou o Vehicle.end_tags contiver dst_tag ou não contiver excluded_dst_tag (dependendo de qual desses dois campos não está vazio).

string

Consulte dst_tag. Exatamente um entre dst_tag e excluded_dst_tag não pode estar vazio.

double

Especifica um custo para realizar essa transição. Essa unidade é a mesma de todos os outros custos no modelo e não pode ser negativa. Ela é aplicada sobre todos os outros custos atuais.

double

Especifica um custo por quilômetro aplicado à distância percorrida durante essa transição. Ele é adicionado a qualquer Vehicle.cost_per_kilometer especificado nos veículos.

DistanceLimit

Especifica um limite para a distância percorrida durante essa transição.

Desde 06/2021, apenas limites flexíveis são aceitos.

Duration

Especifica um atraso incorrido ao realizar essa transição.

Esse atraso sempre ocorre depois de terminar a visita de origem e antes de começar a visita de destino.

string

O URI do recurso. O recurso ainda não existe.

O conteúdo do recurso é codificado como JSON ou textproto. Apenas recursos do Google Cloud Storage são aceitos. Se o recurso for codificado como JSON, o nome dele precisará ter o sufixo .json. Se o recurso for codificado como textproto, o nome dele precisará ter o sufixo .txtpb. Por exemplo, um URI do Google Cloud Storage para um arquivo codificado em JSON pode ter esta aparência: gs://bucket/path/input/object.json.

string

O nome de exibição do veículo definido pelo usuário. Ele pode ter até 63 caracteres e usar caracteres UTF-8.

TravelMode

O modo de viagem que afeta as vias utilizáveis pelo veículo e a velocidade dele. Consulte também travel_duration_multiple.

RouteModifiers

Um conjunto de condições a serem satisfeitas que afetam a forma como as rotas são calculadas para o veículo especificado.

LatLng

Localização geográfica em que o veículo começa antes de pegar qualquer envio. Se não for especificado, o veículo vai começar na primeira coleta. Se o modelo de frete tiver matrizes de duração e distância, start_location não poderá ser especificado.

Waypoint

Ponto de referência que representa um local geográfico onde o veículo começa antes de coletar qualquer entrega. Se nem start_waypoint nem start_location forem especificados, o veículo vai começar na primeira coleta. Se o modelo de frete tiver matrizes de duração e distância, start_waypoint não poderá ser especificado.

LatLng

Localização geográfica em que o veículo termina depois de concluir a última VisitRequest. Se não for especificado, o ShipmentRoute do veículo vai terminar imediatamente quando ele concluir o último VisitRequest. Se o modelo de frete tiver matrizes de duração e distância, end_location não poderá ser especificado.

Waypoint

Ponto de parada que representa um local geográfico em que o veículo termina depois de concluir o último VisitRequest. Se nem end_waypoint nem end_location forem especificados, o ShipmentRoute do veículo vai terminar imediatamente quando concluir o último VisitRequest. Se o modelo de frete tiver matrizes de duração e distância, end_waypoint não poderá ser especificado.

string

Especifica tags anexadas ao início do trajeto do veículo.

Não é permitido usar strings vazias ou duplicadas.

string

Especifica tags anexadas ao final do trajeto do veículo.

Não é permitido usar strings vazias ou duplicadas.

TimeWindow

Períodos em que o veículo pode sair do local de partida. Eles precisam estar dentro dos limites de tempo globais (consulte os campos ShipmentModel.global_*). Se não for especificado, não haverá limitação além dos limites de tempo globais.

Os períodos pertencentes ao mesmo campo repetido precisam ser disjuntos, ou seja, nenhum período pode se sobrepor ou ser adjacente a outro, e eles precisam estar em ordem cronológica.

cost_per_hour_after_soft_end_time e soft_end_time só podem ser definidos se houver um único período.

TimeWindow

Períodos em que o veículo pode chegar ao local de destino. Eles precisam estar dentro dos limites de tempo globais (consulte os campos ShipmentModel.global_*). Se não for especificado, não haverá limitação além dos limites de tempo globais.

Os períodos pertencentes ao mesmo campo repetido precisam ser disjuntos, ou seja, nenhum período pode se sobrepor ou ser adjacente a outro, e eles precisam estar em ordem cronológica.

cost_per_hour_after_soft_end_time e soft_end_time só podem ser definidos se houver um único período.

UnloadingPolicy

Política de descarga aplicada ao veículo.

map<string, LoadLimit>

Capacidades do veículo (peso, volume, número de paletes, por exemplo). As chaves no mapa são os identificadores do tipo de carga, consistentes com as chaves do campo Shipment.load_demands. Se uma determinada chave estiver ausente desse mapa, a capacidade correspondente será considerada ilimitada.

double

Custos do veículo: todos os custos são somados e precisam estar na mesma unidade de Shipment.penalty_cost.

Custo por hora da rota do veículo. Esse custo é aplicado ao tempo total gasto no trajeto e inclui tempo de viagem, tempo de espera e tempo de visita. Usar cost_per_hour em vez de apenas cost_per_traveled_hour pode resultar em latência adicional.

double

Custo por hora de viagem do trajeto do veículo. Esse custo é aplicado apenas ao tempo de viagem do trajeto (ou seja, o informado em ShipmentRoute.transitions) e exclui o tempo de espera e de visita.

double

Custo por quilômetro da rota do veículo. Esse custo é aplicado à distância informada no ShipmentRoute.transitions e não se aplica a nenhuma distância percorrida implicitamente do arrival_location ao departure_location de um único VisitRequest.

double

Custo fixo aplicado se este veículo for usado para lidar com uma remessa.

bool

Esse campo só se aplica a veículos quando a rota deles não atende a nenhuma entrega. Ele indica se o veículo deve ser considerado usado ou não nesse caso.

Se for verdadeiro, o veículo vai do local de início até o de término, mesmo que não atenda a nenhuma entrega, e os custos de tempo e distância resultantes da viagem de início para término serão considerados.

Caso contrário, ele não vai da origem ao destino, e nenhum break_rule ou atraso (de TransitionAttributes) será programado para esse veículo. Nesse caso, o ShipmentRoute do veículo não contém nenhuma informação, exceto o índice e o rótulo do veículo.

DurationLimit

Limite aplicado à duração total do trajeto do veículo. Em um determinado OptimizeToursResponse, a duração do trajeto de um veículo é a diferença entre o vehicle_end_time e o vehicle_start_time.

DurationLimit

Limite aplicado à duração da viagem do trajeto do veículo. Em um determinado OptimizeToursResponse, a duração da viagem do trajeto é a soma de todos os transitions.travel_duration.

DistanceLimit

Limite aplicado à distância total do trajeto do veículo. Em um determinado OptimizeToursResponse, a distância da rota é a soma de todos os transitions.travel_distance_meters.

map<string, Duration>

Especifica um mapa de strings visit_types para durações. A duração é o tempo além de VisitRequest.duration a ser tomado nas visitas com o visit_types especificado. Essa duração extra da visita adiciona custo se cost_per_hour for especificado. As chaves (ou seja, visit_types) não podem ser strings vazias.

Se um pedido de visita tiver vários tipos, uma duração será adicionada para cada tipo no mapa.

BreakRule

Descreve a programação de pausas a ser aplicada neste veículo. Se estiver vazio, nenhuma pausa será programada para esse veículo.

string

Especifica um rótulo para o veículo. Esse rótulo é informado na resposta como o vehicle_label do ShipmentRoute correspondente.

bool

Se for verdadeiro, used_if_route_is_empty precisará ser falso, e o veículo vai permanecer sem uso.

Se um veículo ignorado em injected_first_solution_routes fizer uma entrega, ela será ignorada na primeira solução, mas poderá ser realizada na resposta.

Se um envio for realizado por um veículo ignorado em injected_solution_constraint e qualquer coleta/entrega relacionada for restrita a permanecer no veículo (ou seja, não relaxada para o nível RELAX_ALL_AFTER_THRESHOLD), ela será ignorada na resposta. Se um envio tiver um campo allowed_vehicle_indices não vazio e todos os veículos permitidos forem ignorados, ele será ignorado na resposta.

double

Especifica um fator multiplicativo que pode ser usado para aumentar ou diminuir os tempos de viagem deste veículo. Por exemplo, definir como 2,0 significa que esse veículo é mais lento e tem tempos de viagem que são o dobro dos veículos padrão. Esse múltiplo não afeta as durações das visitas. Isso afeta o custo se cost_per_hour ou cost_per_traveled_hour forem especificados. Precisa estar no intervalo [0,001, 1000,0]. Se não for definido, o veículo será padrão, e esse múltiplo será considerado 1,0.

AVISO: os tempos de viagem serão arredondados para o segundo mais próximo depois que esse múltiplo for aplicado, mas antes de realizar qualquer operação numérica. Portanto, um múltiplo pequeno pode resultar em uma perda de precisão.

Consulte também extra_visit_duration_for_visit_type abaixo.

Duration

Um limite fixo que restringe a duração a no máximo max_duration.

Duration

Um limite flexível que não impõe uma duração máxima, mas que, quando violado, gera um custo para a rota. Esse custo é somado a outros custos definidos no modelo, com a mesma unidade.

Se definido, soft_max_duration não pode ser negativo. Se max_duration também estiver definido, soft_max_duration precisará ser menor que max_duration.

Duration

Um limite flexível que não impõe um limite de duração máxima, mas que, quando violado, faz com que a rota incorra em um custo quadrático na duração. Esse custo é somado a outros custos definidos no modelo, com a mesma unidade.

Se definido, quadratic_soft_max_duration não pode ser negativo. Se max_duration também estiver definido, quadratic_soft_max_duration precisará ser menor que max_duration, e a diferença não poderá ser maior que um dia:

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

Custo por hora incorrido se o limite de soft_max_duration for violado. O custo adicional é 0 se a duração for inferior ao limite. Caso contrário, o custo depende da duração da seguinte forma:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

O custo não pode ser negativo.

double

Custo por hora quadrada incorrido se o limite de quadratic_soft_max_duration for violado.

O custo adicional é 0 se a duração for inferior ao limite. Caso contrário, o custo depende da duração da seguinte forma:

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

O custo não pode ser negativo.

int64

Um limite flexível da carga. Consulte cost_per_unit_above_soft_max.

double

Se a carga exceder soft_max_load ao longo da rota do veículo, a seguinte penalidade de custo será aplicada (apenas uma vez por veículo): (carga - soft_max_load) * cost_per_unit_above_soft_max. Todos os custos são somados e precisam estar na mesma unidade que Shipment.penalty_cost. Os limites flexíveis só podem ser definidos em tipos que se aplicam apenas a retiradas ou apenas a entregas em todo o modelo.

Interval

O intervalo de carga aceitável do veículo no início do trajeto.

Interval

O intervalo de carga aceitável do veículo no final do trajeto.

int64

A quantidade máxima aceitável de carga.

LoadCost

Custo de movimentar uma unidade de carga por um quilômetro para este veículo. Isso pode ser usado como um proxy para o consumo de combustível: se a carga for um peso (em Newtons), carga*quilômetro terá a dimensão de uma energia.

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

LoadCost

Custo de viajar com uma unidade de carga durante uma hora para este veículo.

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

int64

Uma carga mínima aceitável. Precisa ser ≥ 0. Se os dois forem especificados, min precisará ser ≤ max.

int64

Uma carga máxima aceitável. Precisa ser ≥ 0. Se não for especificado, a carga máxima não será restrita por esta mensagem. Se os dois forem especificados, min precisará ser ≤ max.

int64

Quantidade de carga acima da qual o custo de movimentação de uma unidade de carga muda de cost_per_unit_below_threshold para cost_per_unit_above_threshold. Precisa ser >= 0.

double

Custo de movimentação de uma unidade de carga, para cada unidade entre 0 e o limite. Precisa ser um valor finito e >= 0.

double

Custo de movimentação de uma unidade de carga para cada unidade acima do limite. No caso especial em que o limite é igual a 0, esse é um custo fixo por unidade. Precisa ser um valor finito e >= 0.

double

Máximo de todos os outros campos nesta mensagem.

double

A proporção entre AggregatedMetrics.travel_distance_meters e Vehicle.route_distance_limit. Se Vehicle.route_distance_limit não estiver definido, este campo também não estará.

double

A proporção entre [AggregatedMetrics.travel_duration_seconds][] e Vehicle.travel_duration_limit. Se Vehicle.travel_duration_limit não estiver definido, este campo também não estará.

double

A proporção entre [AggregatedMetrics.total_duration_seconds][] e Vehicle.route_duration_limit. Se Vehicle.route_duration_limit não estiver definido, este campo também não estará.

double

A proporção máxima entre todos os tipos de [AggregatedMetrics.max_load][] e os respectivos Vehicle.load_limits. Se todos os campos Vehicle.load_limits não estiverem definidos, este campo também não estará.

double

A proporção (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time) para um determinado veículo. Se o denominador não estiver presente, ele usará (ShipmentModel.global_end_time - ShipmentModel.global_start_time).

bool

Opcional. Indica que o local deste waypoint tem uma preferência para que o veículo pare em um determinado lado da via. Quando você define esse valor, o trajeto passa pelo local para que o veículo possa parar na lateral da via em que o local está mais próximo do centro da via. Essa opção não funciona para o modo de viagem "A PÉ".

bool

Indica que o waypoint é destinado a veículos para parar, com a intenção de pegar ou deixar alguém. Essa opção funciona apenas para o modo de viagem "CARRO" e quando o "location_type" é "location".

Experimental: o comportamento ou a existência deste campo podem mudar no futuro.

Location

Um ponto especificado usando coordenadas geográficas, incluindo um título opcional.

string

O ID do lugar do PDI associado ao ponto de referência.

Ao usar um ID de lugar para especificar o local de chegada ou partida de um VisitRequest, use um ID de lugar específico o suficiente para determinar um local LatLng para navegação até o lugar. Por exemplo, um ID de lugar que representa um edifício é adequado, mas um ID de lugar que representa uma rua não é recomendado.