ShipmentModel

string

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

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

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

integer

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.

number

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 costsPerVehicleIndices. costsPerVehicle[i] corresponde ao veículo costsPerVehicleIndices[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 penaltyCost e não podem ser negativos. Deixe esse campo em branco se não houver custos desse tipo.

integer

Índices dos veículos a que costsPerVehicle se aplica. Se não estiver vazio, precisará 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 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 pickupToDeliveryAbsoluteDetourLimit impõe:

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

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.

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

string (Duration format)

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.

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

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 shipmentTypeIncompatibilities e shipmentTypeRequirements em ShipmentModel).

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

string

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

boolean

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

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

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

number

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.

number

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 pickupToDeliveryRelativeDetourLimit impõe:

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

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.

object (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, arrivalLocation não poderá ser especificado.

object (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, arrivalWaypoint não poderá ser especificado.

object (LatLng)

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

object (Waypoint)

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

string

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

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

costPerHourAfterSoftEndTime e softEndTime só podem ser definidos se houver um único período.

string (Duration format)

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 timeWindows).

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

number

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 (key: string, value: object (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 visitLabel no ShipmentRoute.Visit correspondente.

boolean

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.

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

boolean

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 "locationType" é "location".

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

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

object (LatLng)

As coordenadas geográficas do ponto de parada.

integer

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 (Timestamp format)

O horário de início do período rígido. Se não for especificado, 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 fixo. Se não for especificado, 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 gradual 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 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".

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 utilizáveis pelo veículo e a velocidade dele. Consulte também travelDurationMultiple.

object (RouteModifiers)

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

object (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, startLocation não poderá ser especificado.

object (Waypoint)

Ponto de referência que representa um local geográfico onde o veículo começa antes de coletar qualquer entrega. Se nem startWaypoint nem startLocation forem especificados, o veículo vai começar na primeira coleta. Se o modelo de frete 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 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, endLocation não poderá ser especificado.

object (Waypoint)

Ponto de parada que representa um local geográfico em que 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 concluir o último VisitRequest. Se o modelo de frete tiver matrizes de duração e distância, endWaypoint 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.

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

costPerHourAfterSoftEndTime e softEndTime só podem ser definidos se houver um único período.

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

costPerHourAfterSoftEndTime e softEndTime só podem ser definidos se houver um único período.

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 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 costPerHour em vez de apenas costPerTraveledHour pode resultar em latência adicional.

number

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.

number

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 arrivalLocation ao departureLocation de um único VisitRequest.

number

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

boolean

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

object (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 vehicleEndTime e o 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 da rota é 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 a ser tomado 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 um pedido 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 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 vehicleLabel do ShipmentRoute correspondente.

boolean

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

Se um veículo ignorado em injectedFirstSolutionRoutes 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 injectedSolutionConstraint 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 allowedVehicleIndices não vazio e todos os veículos permitidos forem ignorados, ele será ignorado na resposta.

number

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 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. A preferência será dada a trajetos sem pedágios. Válido apenas para modos de viagem motorizados.

boolean

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.

boolean

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.

boolean

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 (int64 format)

Um limite flexível da carga. Consulte costPerUnitAboveSoftMax.

number

Se a carga exceder softMaxLoad ao longo da rota do 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 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.

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 os dois forem especificados, min precisará ser ≤ max.

string (int64 format)

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.

string (int64 format)

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

number

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

number

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.

string (Duration format)

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

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

string (Duration format)

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, softMaxDuration não pode ser negativo. Se maxDuration também estiver definido, softMaxDuration precisará ser menor que maxDuration.

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

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

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

maxDuration - quadraticSoftMaxDuration <= 86400 seconds

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

number

Custo por hora incorrido se o limite de softMaxDuration 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:

  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 é 0 se a duração for inferior ao limite. Caso contrário, o custo depende da duração da seguinte forma:

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

O custo não pode ser negativo.

string (int64 format)

Um limite fixo 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, 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 negativo.

number

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

  min(distanceMeters, softMaxMeters) / 1000.0 *
  costPerKilometerBelowSoftMax.

Esse custo não é compatível com 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) do 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) do 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.

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

string (Duration format)

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

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

string (Duration format)

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 >= minBreakDuration. Precisa ser positivo.

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

enum (Type)

O tipo de 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 têm como padrã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 campo 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 para uma determinada linha. Ele precisa ter o mesmo número de elementos que ShipmentModel.duration_distance_matrix_dst_tags.

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

number

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.

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 srcTag ou não contiver excludedSrcTag (dependendo de qual desses dois campos não está vazio).

string

Consulte srcTag. Exatamente um entre srcTag e excludedSrcTag não pode estar vazio.

string

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

string

Consulte dstTag. Exatamente um entre dstTag e excludedDstTag não pode estar vazio.

number

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.

number

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.

object (DistanceLimit)

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

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

string (Duration format)

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.

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

string

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

enum (IncompatibilityMode)

Modo aplicado à incompatibilidade.

string

Lista de tipos de frete 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 no mesmo trajeto.

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 evento "first" é uma entrega.

boolean

Indica se o evento "segundo" é uma entrega.

string (Duration format)

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

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

integer

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

integer

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