ShipmentModel

string

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

object (VisitRequest)

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

object (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 (key: string, value: object (Load))

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

integer

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

number

Especifica o custo incorrido quando essa remessa é entregue por cada veículo. Se especificado, ele precisa ter:

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

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

integer

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

string (Duration format)

Especifica o tempo máximo absoluto de desvio em comparação com o trajeto mais curto da retirada até a entrega. Se especificado, ele precisa ser não negativo, e a remessa precisa conter pelo menos uma retirada 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 de pickupToDeliveryAbsoluteDetourLimit aplica:

startTime(delivery) - startTime(pickup) <=
t + pickupToDeliveryAbsoluteDetourLimit

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

string (Duration format)

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

string

String não vazia que especifica um "tipo" para essa remessa. Esse recurso pode ser usado para definir incompatibilidades ou requisitos entre shipment_types (consulte shipmentTypeIncompatibilities e shipmentTypeRequirements em ShipmentModel).

Diferente de visitTypes, que é especificado para uma única visita: todas as coletas/entregas que pertencem à mesma remessa compartilham o mesmo shipmentType.

string

Especifica um rótulo para esta remessa. Esse rótulo é informado na resposta no shipmentLabel do ShipmentRoute.Visit correspondente.

boolean

Se for verdadeiro, pule esta remessa, mas não aplique um penaltyCost.

Ignorar uma remessa resulta em um erro de validação quando há shipmentTypeRequirements no modelo.

É permitido ignorar uma remessa realizada em injectedFirstSolutionRoutes ou injectedSolutionConstraint. O solucionador remove as visitas de retirada/entrega relacionadas da rota de realização. precedenceRules que se referem a remessas ignoradas também serão ignorados.

number

Se a remessa não for concluída, essa penalidade será adicionada ao custo geral das rotas. 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 ao custo 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.

number

Especifica o tempo máximo de desvio relativo em comparação com o trajeto mais curto da retirada até a entrega. Se especificado, ele precisa ser não negativo, e a remessa precisa conter pelo menos uma retirada 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 de pickupToDeliveryRelativeDetourLimit aplica:

startTime(delivery) - startTime(pickup) <=
std::ceil(t * (1.0 + pickupToDeliveryRelativeDetourLimit))

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

object (LatLng)

A localização geográfica em que o veículo chega ao realizar essa VisitRequest. Se o modelo de remessa tiver matrizes de distância de duração, arrivalLocation não poderá ser especificado.

object (Waypoint)

O waypoint em que o veículo chega ao realizar essa VisitRequest. Se o modelo de remessa tiver matrizes de distância de duração, arrivalWaypoint não poderá ser especificado.

object (LatLng)

A localização geográfica de onde o veículo parte depois de concluir este VisitRequest. Pode ser omitido se for igual a arrivalLocation. Se o modelo de remessa tiver matrizes de distância de duração, departureLocation não poderá ser especificado.

object (Waypoint)

O waypoint de onde o veículo sai depois de concluir este VisitRequest. Pode ser omitido se for igual a arrivalWaypoint. Se o modelo de remessa tiver matrizes de distância de duração, departureWaypoint não poderá ser especificado.

string

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

object (TimeWindow)

Janelas de tempo que restringem o horário de chegada em uma visita. Um veículo pode sair fora da janela de horário de chegada, ou seja, o horário de chegada + a duração não precisam estar dentro de uma janela de horário. 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 realizar essa visita a qualquer momento.

As janelas de tempo precisam ser separadas, ou seja, nenhuma janela de tempo pode se sobrepor ou ser adjacente a outra, e elas precisam estar em ordem crescente.

costPerHourAfterSoftEndTime e softEndTime só podem ser definidos se houver uma única janela de tempo.

string (Duration format)

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

number

Custo para atender a essa solicitação de visita em uma rota 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 (key: string, value: object (Load))

Carregue as demandas dessa 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 visitLabel no ShipmentRoute.Visit correspondente.

boolean

Especifica se as conversões devem ser evitadas em trajetos de carro nesse local. A prevenção de retornos é feita da melhor forma possível, e não há garantia de que eles serão totalmente evitados. Este é um recurso experimental, e o comportamento está sujeito a mudanças.

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

number

A latitude em graus. Precisa estar no intervalo [-90,0, +90,0].

number

A longitude em graus. Precisa estar no intervalo [-180,0, +180,0].

boolean

Opcional. Indica que o local desse waypoint deve ter uma preferência para que o veículo pare em um lado específico da via. Quando você define esse valor, o trajeto passa pelo local para que o veículo possa parar no lado da via em que o local está, em relação ao centro da via. Essa opção não funciona para o modo de viagem "WALKING".

boolean

Indica que o waypoint é destinado à parada de veículos, com a intenção de embarque ou desembarque. Essa opção funciona apenas para o modo de viagem "DRIVING" e quando o "locationType" é "location".

Experimental: o comportamento ou a existência desse campo pode mudar no futuro.

object (Location)

Um ponto especificado usando coordenadas geográficas, incluindo uma direção opcional.

string

O ID de lugar do PDI associado ao waypoint.

Ao usar um ID de lugar para especificar o local de chegada ou partida de um VisitRequest, use um ID de lugar que seja 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 que representa uma estrada não é recomendado.

object (LatLng)

As coordenadas geográficas do waypoint.

integer

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

string (Timestamp format)

O horário de início da janela de tempo rígida. Se não for especificado, ele será definido como ShipmentModel.global_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".

string (Timestamp format)

O horário de término do período rígido. Se não for especificado, ele será definido como ShipmentModel.global_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".

string (Timestamp format)

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

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".

string (Timestamp format)

O horário de término flexível da janela de tempo.

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".

number

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

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

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

number

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

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

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

string

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

enum (TravelMode)

O modo de viagem, que afeta as vias que o veículo pode usar e a velocidade dele. Consulte também travelDurationMultiple.

object (RouteModifiers)

Um conjunto de condições que afetam a forma como os trajetos são calculados para o veículo em questão.

object (LatLng)

Localização geográfica em que o veículo começa antes de coletar as remessas. Se não for especificado, o veículo vai começar na primeira retirada. Se o modelo de remessa tiver matrizes de duração e distância, startLocation não poderá ser especificado.

object (Waypoint)

Ponto de passagem que representa uma localização geográfica em que o veículo começa antes de retirar as remessas. Se nem startWaypoint nem startLocation forem especificados, o veículo vai começar na primeira retirada. Se o modelo de remessa tiver matrizes de duração e distância, startWaypoint não poderá ser especificado.

object (LatLng)

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

object (Waypoint)

Waypoint que representa uma localização geográfica onde o veículo termina depois de concluir o último VisitRequest. Se nem endWaypoint nem endLocation forem especificados, o ShipmentRoute do veículo vai terminar imediatamente quando ele concluir o último VisitRequest. Se o modelo de remessa tiver matrizes de duração e distância, endWaypoint não poderá ser especificado.

string

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

Não é permitido usar strings vazias ou duplicadas.

string

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

Não é permitido usar strings vazias ou duplicadas.

object (TimeWindow)

Janelas de tempo 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 desses limites de tempo globais.

As janelas de tempo que pertencem ao mesmo campo repetido precisam ser separadas, ou seja, nenhuma janela de tempo pode se sobrepor ou ser adjacente a outra, e elas precisam estar em ordem cronológica.

costPerHourAfterSoftEndTime e softEndTime só podem ser definidos se houver uma única janela de tempo.

object (TimeWindow)

Janelas de tempo em que o veículo pode chegar ao local final. 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 desses limites de tempo globais.

As janelas de tempo que pertencem ao mesmo campo repetido precisam ser separadas, ou seja, nenhuma janela de tempo pode se sobrepor ou ser adjacente a outra, e elas precisam estar em ordem cronológica.

costPerHourAfterSoftEndTime e softEndTime só podem ser definidos se houver uma única janela de tempo.

enum (UnloadingPolicy)

Política de descarga aplicada ao veículo.

map (key: string, value: object (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.

number

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

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

number

Custo por hora percorrida 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.

number

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

number

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

boolean

Esse campo só se aplica a veículos quando o trajeto deles não atende a nenhuma remessa. Indica se o veículo deve ser considerado como usado ou não nesse caso.

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

Caso contrário, ele não vai do local de início ao de término, e nenhum breakRule ou atraso (de TransitionAttributes) é 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.

object (DurationLimit)

Limite aplicado à duração total do trajeto do veículo. Em uma determinada OptimizeToursResponse, a duração do trajeto de um veículo é a diferença entre vehicleEndTime e vehicleStartTime.

object (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.

object (DistanceLimit)

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

map (key: string, value: string (Duration format))

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

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

object (BreakRule)

Descreve a programação de pausas a ser aplicada a este veículo. Se estiver vazio, nenhum intervalo será programado para esse veículo.

string

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

boolean

Se for verdadeiro, usedIfRouteIsEmpty precisará ser falso, e o veículo não será usado.

Se uma remessa for realizada por um veículo ignorado em injectedFirstSolutionRoutes, ela será ignorada na primeira solução, mas poderá ser realizada na resposta.

Se uma remessa for realizada por um veículo ignorado em injectedSolutionConstraint e qualquer retirada/entrega relacionada for restrita para permanecer no veículo (ou seja, não for relaxada para o nível RELAX_ALL_AFTER_THRESHOLD), ela será ignorada na resposta. Se uma remessa tiver um campo allowedVehicleIndices não vazio e todos os veículos permitidos forem ignorados, ela será ignorada na resposta.

number

Especifica um fator multiplicativo que pode ser usado para aumentar ou diminuir os tempos de viagem desse veículo. Por exemplo, definir esse valor como 2,0 significa que o veículo é mais lento e tem tempos de viagem duas vezes maiores do que os de veículos padrão. Esse múltiplo não afeta a duração das visitas. Ele afeta o custo se costPerHour ou costPerTraveledHour 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 extraVisitDurationForVisitType abaixo.

boolean

Especifica se é preciso evitar vias com pedágio quando possível. Será dada preferência a rotas que não contenham vias com pedágio. Aplica-se apenas a meios de transporte motorizados.

boolean

Especifica se é preciso evitar rodovias quando possível. A preferência será dada a rotas que não contenham rodovias. Aplica-se apenas a meios de transporte motorizados.

boolean

Especifica se é preciso evitar balsas quando possível. Será dada preferência a rotas que não incluam viagens de balsa. Aplica-se apenas a meios de transporte motorizados.

boolean

Opcional. Especifica se é preciso evitar a navegação em ambientes fechados, quando possível. Será dada preferência a rotas que não contenham navegação interna. Aplica-se apenas ao meio de transporte WALKING.

string (int64 format)

Um limite flexível da carga. Consulte costPerUnitAboveSoftMax.

number

Se a carga exceder softMaxLoad ao longo do trajeto desse veículo, a seguinte penalidade de custo será aplicada (apenas uma vez por veículo): (carga - softMaxLoad) * costPerUnitAboveSoftMax. 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.

object (Interval)

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

object (Interval)

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

string (int64 format)

A quantidade máxima aceitável de carga.

object (LoadCost)

Custo de mover 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), então 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.

object (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.

string (int64 format)

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

string (int64 format)

Uma carga máxima aceitável. Precisa ser ≥ 0. Se não for especificada, a carga máxima não será restrita por essa mensagem. Se ambos forem especificados, min precisa ser ≤ max.

string (int64 format)

Quantidade de carga acima da qual o custo de mover uma unidade de carga muda de costPerUnitBelowThreshold para costPerUnitAboveThreshold. Precisa ser >= 0.

number

Custo de mover uma unidade de carga, para cada unidade entre 0 e o limite. Precisa ser um valor finito e maior ou igual a 0.

number

Custo de mover uma unidade de carga para cada unidade acima do limite. No caso especial de limite = 0, esse é um custo fixo por unidade. Precisa ser um valor finito e maior ou igual a 0.

string (Duration format)

Um limite rígido que restringe a duração a, no máximo, maxDuration.

string (Duration format)

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 tenha um custo. Esse custo é adicionado a outros custos definidos no modelo, com a mesma unidade.

Se definido, softMaxDuration precisa ser não negativo. Se maxDuration também for definido, softMaxDuration precisará ser menor que maxDuration.

string (Duration format)

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 é adicionado a outros custos definidos no modelo, com a mesma unidade.

Se quadraticSoftMaxDuration estiver definido, as seguintes condições precisarão ser atendidas:

• Não pode ser negativo.
• maxDuration precisa ser definido.
• quadraticSoftMaxDuration precisa ser menor que maxDuration.
• A diferença não pode ser maior que um dia: maxDuration - quadraticSoftMaxDuration <= 86400 seconds

number

Custo por hora incorrido se o limite de softMaxDuration for violado. O custo adicional será 0 se a duração estiver abaixo do limite. Caso contrário, o custo vai depender da duração, conforme indicado abaixo:

  costPerHourAfterSoftMax * (duration - softMaxDuration)

O custo não pode ser negativo.

number

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

O custo adicional será 0 se a duração estiver abaixo do limite. Caso contrário, o custo vai depender da duração, conforme indicado abaixo:

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

O custo não pode ser negativo.

string (int64 format)

Um limite rígido que restringe a distância a, no máximo, maxMeters. O limite não pode ser negativo.

string (int64 format)

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

Se definido, softMaxMeters precisa ser menor que maxMeters e não pode ser negativo.

number

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

  min(distanceMeters, softMaxMeters) / 1000.0 *
  costPerKilometerBelowSoftMax.

Esse custo não é aceito em routeDistanceLimit.

number

Custo por quilômetro incorrido se a distância estiver acima do limite de softMaxMeters. 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:

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

O custo não pode ser negativo.

object (BreakRequest)

Sequência de intervalos. Confira a mensagem BreakRequest.

object (FrequencyConstraint)

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

string (Timestamp format)

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

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".

string (Timestamp format)

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

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".

string (Duration format)

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

string (Duration format)

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

string (Duration format)

Obrigatório. Duração máxima permitida de qualquer intervalo de tempo no trajeto que não inclua, pelo menos parcialmente, uma pausa de duration >= minBreakDuration. Precisa ser positivo.

enum (Type)

O tipo do objetivo.

number

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 padrão são 1,0.

object (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 dos campos startTags precisa corresponder ao vehicleStartTag de uma matriz (e somente dessa matriz).

Todas as matrizes precisam ter um vehicleStartTag diferente.

string (Duration format)

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

number

Valores de distância para uma determinada linha. Se nenhum custo ou restrição se referir a distâncias no modelo, esse campo poderá ser deixado em branco. Caso contrário, ele precisará ter tantos elementos quanto durations.

string

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

Uma visita de origem ou início de veículo corresponde se o VisitRequest.tags ou Vehicle.start_tags contém srcTag ou não contém excludedSrcTag (dependendo de qual desses dois campos não está vazio).

string

Consulte srcTag. Exatamente um dos campos srcTag e excludedSrcTag precisa ser preenchido.

string

Uma visita de destino ou um fim de veículo corresponderá se, e somente se, o VisitRequest.tags ou o Vehicle.end_tags contiver dstTag ou não contiver excludedDstTag (dependendo de qual desses dois campos não estiver vazio).

string

Consulte dstTag. Exatamente um dos campos dstTag e excludedDstTag precisa ser preenchido.

number

Especifica um custo para realizar essa transição. Ele está na mesma unidade que todos os outros custos no modelo e não pode ser negativo. Ela é aplicada sobre todos os outros custos.

number

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

object (DistanceLimit)

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

A partir de junho de 2021, apenas limites flexíveis são aceitos.

string (Duration format)

Especifica um atraso ao realizar essa transição.

Esse atraso sempre ocorre depois de terminar a visita de origem e antes de iniciar a visita de destino.

string

Lista de tipos incompatíveis. Duas remessas com shipment_types diferentes entre as listadas são "incompatíveis".

enum (IncompatibilityMode)

Modo aplicado à incompatibilidade.

string

Lista de tipos de envio alternativos exigidos pelo dependentShipmentTypes.

string

Todas as remessas com um tipo no campo dependentShipmentTypes exigem que pelo menos uma remessa do tipo requiredShipmentTypeAlternatives seja visitada na mesma rota.

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

enum (RequirementMode)

Modo aplicado ao requisito.

boolean

Indica se o "primeiro" evento é uma entrega.

boolean

Indica se o "segundo" evento é uma entrega.

string (Duration format)

O deslocamento entre o "primeiro" e o "segundo" evento. Pode ser negativo.

integer

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

integer

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