ShipmentModel

string

Отображаемое имя отправления, определяемое пользователем. Длина имени может составлять до 63 символов, допускается использование символов UTF-8.

object ( VisitRequest )

Набор вариантов забора груза, связанных с отправкой. Если не указано иное, транспортное средство должно заехать только в место, соответствующее доставке.

object ( VisitRequest )

Набор вариантов доставки, связанных с отправлением. Если не указано иное, транспортное средство должно заехать только в место, соответствующее месту забора груза.

map (key: string, value: object ( Load ))

Требования к загрузке груза (например, вес, объём, количество поддонов и т. д.). Ключами на карте должны быть идентификаторы, описывающие тип соответствующего груза, в идеале также с указанием единиц измерения. Например: «weight_kg», «volume_gallons», «pallet_count» и т. д. Если заданный ключ отсутствует на карте, соответствующий груз считается пустым.

integer

Набор транспортных средств, которые могут выполнить эту перевозку. Если этот список пуст, её могут выполнить все транспортные средства. Транспортные средства указаны по индексу в списке vehicles ShipmentModel .

number

Указывает стоимость доставки груза каждым транспортным средством. Если указано, необходимо указать ОДНО ИЗ следующих условий:

• то же количество элементов, что и costsPerVehicleIndices . costsPerVehicle[i] соответствует costsPerVehicleIndices[i] транспортного средства модели.
• Число элементов равно числу транспортных средств в модели. i-й элемент соответствует транспортному средству № i в модели.

Эти расходы должны быть выражены в тех же единицах, что и penaltyCost , и не должны быть отрицательными. Оставьте это поле пустым, если таких расходов нет.

integer

Индексы транспортных средств, к которым применяется costsPerVehicle . Если поле не пустое, оно должно иметь то же количество элементов, что и costsPerVehicle . Индекс транспортного средства не может быть указан более одного раза. Если транспортное средство исключено из costsPerVehicleIndices , его стоимость равна нулю.

string ( Duration format)

Указывает максимальное абсолютное время в пути по сравнению с кратчайшим путём от пункта забора до пункта доставки. Если указано, оно должно быть неотрицательным, а отправление должно включать как минимум пункт забора и пункт доставки.

Например, пусть t — кратчайшее время, необходимое для достижения выбранного варианта самовывоза непосредственно до выбранного варианта доставки. Тогда установка pickupToDeliveryAbsoluteDetourLimit обеспечит:

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

Если для одной и той же партии груза указаны как относительные, так и абсолютные ограничения, для каждой возможной пары «забор/доставка» используется более строгий предел. С 2017/10 года объезды поддерживаются только в тех случаях, когда продолжительность поездки не зависит от транспортных средств.

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивается на « s ». Пример: "3.5s" .

string ( Duration format)

Указывает максимальную продолжительность от начала забора до начала доставки груза. Если указано, это значение должно быть неотрицательным, и груз должен включать как минимум забор и доставку. Это не зависит от выбранных вариантов забора и доставки, а также от скорости транспортного средства. Это значение можно указать вместе с ограничениями на максимальный объезд: решение будет учитывать оба параметра.

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивается на « s ». Пример: "3.5s" .

string

Непустая строка, указывающая «тип» для данной поставки. Эту функцию можно использовать для определения несовместимостей или требований между shipment_types (см. shipmentTypeIncompatibilities и shipmentTypeRequirements в ShipmentModel ).

Отличается от visitTypes , который указывается для одного посещения: все самовывозы/доставки, относящиеся к одной и той же отправке, имеют один и тот же shipmentType .

string

Указывает метку для данного отправления. Эта метка указывается в ответе shipmentLabel соответствующего ShipmentRoute.Visit .

boolean

Если да, пропустите эту отправку, но не применяйте penaltyCost .

Игнорирование отгрузки приводит к ошибке проверки, если в модели есть хотя бы одно shipmentTypeRequirements .

Игнорирование отгрузки, выполненной в injectedFirstSolutionRoutes или injectedSolutionConstraint , разрешено; решатель удаляет соответствующие визиты забора/доставки из выполняемого маршрута. precedenceRules , которые ссылаются на игнорируемые отгрузки, также будут игнорироваться.

number

Если отправка не выполнена, этот штраф добавляется к общей стоимости маршрутов. Отправка считается выполненной, если использован один из вариантов забора и доставки. Стоимость может быть выражена в тех же единицах, что и все остальные поля модели, связанные со стоимостью, и должна быть положительной.

ВАЖНО : Если данный штраф не указан, он считается бесконечным, т.е. отправка должна быть завершена.

number

Указывает максимальное относительное время в пути по сравнению с кратчайшим путём от пункта забора до пункта доставки. Если указано, оно должно быть неотрицательным, а отправление должно включать как минимум пункт забора и пункт доставки.

Например, пусть t — кратчайшее время, необходимое для достижения выбранного варианта самовывоза непосредственно до выбранного варианта доставки. Тогда установка pickupToDeliveryRelativeDetourLimit обеспечит:

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

Если для одной и той же партии груза указаны как относительные, так и абсолютные ограничения, для каждой возможной пары «забор/доставка» используется более строгий предел. С 2017/10 года объезды поддерживаются только в тех случаях, когда продолжительность поездки не зависит от транспортных средств.

object ( LatLng )

Геолокация, куда прибывает транспортное средство при выполнении этого VisitRequest . Если модель доставки содержит матрицы длительности и расстояния, arrivalLocation указывать не нужно.

object ( Waypoint )

Точка прибытия транспортного средства при выполнении этого VisitRequest . Если модель доставки содержит матрицы длительности и расстояния, arrivalWaypoint указывать не нужно.

object ( LatLng )

Геолокация, откуда отправляется транспортное средство после выполнения этого VisitRequest . Может быть опущена, если она совпадает с arrivalLocation . Если модель доставки содержит матрицы длительности и расстояния, departureLocation указывать не нужно.

object ( Waypoint )

Точка отправления транспортного средства после выполнения этого VisitRequest . Может быть опущена, если она совпадает с arrivalWaypoint . Если модель доставки содержит матрицы длительности и расстояния, departureWaypoint указывать не нужно.

string

Указывает теги, прикреплённые к запросу на посещение. Пустые или дублирующиеся строки не допускаются.

object ( TimeWindow )

Временные окна, ограничивающие время прибытия в момент посещения. Обратите внимание, что транспортное средство может отбыть за пределами временного окна прибытия, то есть время прибытия и продолжительность не обязательно должны находиться внутри временного окна. Это может привести к ожиданию, если транспортное средство прибудет до TimeWindow.start_time .

Отсутствие TimeWindow означает, что транспортное средство может осуществить этот визит в любое время.

Временные окна должны быть непересекающимися, т.е. ни одно временное окно не должно перекрываться или быть смежным с другим, и они должны располагаться в порядке возрастания.

costPerHourAfterSoftEndTime и softEndTime можно задать только при наличии одного временного окна.

string ( Duration format)

Продолжительность визита, т. е. время, проведенное транспортным средством между прибытием и отправлением (прибавляется к возможному времени ожидания; см. timeWindows ).

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивается на « s ». Пример: "3.5s" .

number

Стоимость обслуживания этого запроса на посещение по маршруту транспортного средства. Эта сумма может быть использована для оплаты различных вариантов забора или доставки груза. Эта стоимость должна быть выражена в тех же единицах, что и Shipment.penalty_cost , и не должна быть отрицательной.

map (key: string, value: object ( Load ))

Требования к загрузке для этого запроса на посещение. Это похоже на поле Shipment.load_demands , но применяется только к данному VisitRequest а не ко всему Shipment . Перечисленные здесь требования добавляются к требованиям, перечисленным в Shipment.load_demands .

string

Указывает типы визита. Это может быть использовано для выделения дополнительного времени, необходимого транспортному средству для завершения этого визита (см. Vehicle.extra_visit_duration_for_visit_type ).

Тип может встречаться только один раз.

string

Задаёт метку для данного VisitRequest . Эта метка указывается в ответе как visitLabel в соответствующем ShipmentRoute.Visit .

boolean

Указывает, следует ли избегать разворотов на маршрутах в данном месте. Избегать разворотов — это наилучший вариант, и полное предотвращение разворотов не гарантируется. Это экспериментальная функция, и её поведение может измениться.

Экспериментальный вариант: более подробную информацию см. на странице https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request .

number

Широта в градусах. Должна быть в диапазоне [-90,0, +90,0].

number

Долгота в градусах. Должна быть в диапазоне [-180,0, +180,0].

boolean

Необязательно. Указывает, что местоположение этой путевой точки должно быть приоритетным для остановки транспортного средства на определённой стороне дороги. При установке этого значения маршрут будет проходить через эту точку, чтобы транспортное средство могло остановиться на той стороне дороги, к которой она смещена относительно центра дороги. Эта опция не работает в режиме движения «ПЕШКОМ».

boolean

Указывает, что путевая точка предназначена для остановки транспортных средств с целью посадки или высадки пассажиров. Эта опция работает только для режима движения «ВОЖДЕНИЕ» и если для параметра «locationType» задано значение «location».

Экспериментальный: поведение или существование этого поля может измениться в будущем.

object ( Location )

Точка, указанная с использованием географических координат, включая необязательный заголовок.

string

Идентификатор точки интереса (POI), связанный с путевой точкой.

При использовании идентификатора места для указания места прибытия или отправления в запросе VisitRequest используйте идентификатор, достаточно точный для определения координат LatLng для навигации к этому месту. Например, идентификатор здания подойдёт, но идентификатор дороги использовать не рекомендуется.

object ( LatLng )

Географические координаты точки маршрута.

integer

Направление по компасу, соответствующее направлению движения транспорта. Это значение используется для указания стороны дороги, с которой следует производить посадку и высадку пассажиров. Значение направления может быть от 0 до 360, где 0 указывает направление на север, 90 — на восток и т. д.

string ( Timestamp format)

Время начала жёсткого временного окна. Если не указано, будет установлено значение ShipmentModel.global_start_time .

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

string ( Timestamp format)

Время окончания жёсткого временного окна. Если не указано, будет установлено значение ShipmentModel.global_end_time .

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

string ( Timestamp format)

Время плавного запуска временного окна.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

string ( Timestamp format)

Мягкое конечное время временного окна.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

number

Стоимость в час, добавленная к другим затратам в модели, если событие происходит до softStartTime, вычисляется как:

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

Эта стоимость должна быть положительной, и поле может быть установлено только в том случае, если установлено softStartTime.

number

Стоимость в час, добавленная к другим затратам в модели, если событие происходит после softEndTime , вычисляется как:

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

Эта стоимость должна быть положительной, и поле может быть установлено только в том случае, если установлено softEndTime .

string

Отображаемое имя транспортного средства, определяемое пользователем. Длина имени может составлять до 63 символов, в кодировке UTF-8.

enum ( TravelMode )

Режим движения, влияющий на дороги, используемые транспортным средством, и его скорость. См. также travelDurationMultiple .

object ( RouteModifiers )

Набор условий, которые необходимо выполнить и которые влияют на способ расчета маршрутов для данного транспортного средства.

object ( LatLng )

Географическое местоположение, откуда транспортное средство отправляется перед погрузкой. Если не указано, транспортное средство отправляется с места первой погрузки. Если модель доставки включает матрицы длительности и расстояния, startLocation указывать не нужно.

object ( Waypoint )

Точка маршрута, представляющая собой географическое местоположение, откуда транспортное средство начинает движение перед погрузкой. Если не указаны ни startWaypoint , ни startLocation , транспортное средство начинает движение с первого пункта погрузки. Если модель доставки содержит матрицы длительности и расстояния, startWaypoint указывать не нужно.

object ( LatLng )

Географическое местоположение, в котором транспортное средство завершает свой последний VisitRequest . Если не указано, ShipmentRoute транспортного средства завершается немедленно после завершения последнего VisitRequest . Если модель доставки содержит матрицы длительности и расстояния, endLocation указывать не нужно.

object ( Waypoint )

Точка маршрута, представляющая географическое местоположение, в котором транспортное средство завершает свой последний VisitRequest . Если не указаны ни endWaypoint , ни endLocation , ShipmentRoute транспортного средства завершается немедленно после завершения последнего VisitRequest . Если модель доставки содержит матрицы длительности и расстояния, endWaypoint указывать не нужно.

string

Указывает теги, прикрепленные к началу маршрута транспортного средства.

Пустые или дублирующиеся строки не допускаются.

string

Указывает теги, прикрепленные к концу маршрута транспортного средства.

Пустые или дублирующиеся строки не допускаются.

object ( TimeWindow )

Временные интервалы, в течение которых транспортное средство может покинуть пункт отправления. Они должны соответствовать глобальным временным ограничениям (см. поля ShipmentModel.global_* ). Если не указано иное, то никаких ограничений, помимо этих глобальных временных ограничений, нет.

Временные окна, принадлежащие одному и тому же повторяющемуся полю, должны быть непересекающимися, т.е. ни одно временное окно не может перекрываться или быть смежным с другим, и они должны располагаться в хронологическом порядке.

costPerHourAfterSoftEndTime и softEndTime можно задать только при наличии одного временного окна.

object ( TimeWindow )

Временные интервалы, в течение которых транспортное средство может прибыть в конечный пункт назначения. Они должны соответствовать глобальным временным ограничениям (см. поля ShipmentModel.global_* ). Если не указано иное, то никаких ограничений, помимо этих глобальных временных ограничений, нет.

Временные окна, принадлежащие одному и тому же повторяющемуся полю, должны быть непересекающимися, т.е. ни одно временное окно не может перекрываться или быть смежным с другим, и они должны располагаться в хронологическом порядке.

costPerHourAfterSoftEndTime и softEndTime можно задать только при наличии одного временного окна.

enum ( UnloadingPolicy )

В отношении транспортного средства применяются правила разгрузки.

map (key: string, value: object ( LoadLimit ))

Грузоподъёмность транспортного средства (например, вес, объём, количество поддонов). Ключи в карте — это идентификаторы типа груза, соответствующие ключам поля Shipment.load_demands . Если указанный ключ отсутствует в карте, соответствующая грузоподъёмность считается неограниченной.

number

Стоимость транспортного средства: все расходы суммируются и должны быть выражены в тех же единицах, что и Shipment.penalty_cost .

Стоимость часа в пути транспортного средства. Эта стоимость применяется к общему времени, затраченному на маршрут, и включает время в пути, время ожидания и время посещения. Использование costPerHour вместо costPerTraveledHour может привести к дополнительной задержке.

number

Стоимость за час в пути по маршруту транспортного средства. Эта стоимость применяется только к времени, затраченному на поездку по маршруту (т.е. указанному в ShipmentRoute.transitions ), и не включает время ожидания и время посещения.

number

Стоимость за километр маршрута транспортного средства. Эта стоимость применяется к расстоянию, указанному в ShipmentRoute.transitions , и не применяется к расстоянию, неявно пройденному от arrivalLocation до departureLocation одного VisitRequest .

number

Фиксированная стоимость применяется, если данное транспортное средство используется для перевозки груза.

boolean

Это поле применяется только к транспортным средствам, маршрут которых не обслуживает грузы. Оно указывает, следует ли в этом случае считать транспортное средство подержанным.

Если значение true, транспортное средство следует из начальной точки в конечную, даже если оно не обслуживает никаких грузов, а также учитываются затраты времени и расстояния, возникающие в результате его перемещения из начальной точки в конечную.

В противном случае он не перемещается из начальной точки в конечную, и для этого транспортного средства не запланированы breakRule или задержка (из TransitionAttributes ). В этом случае ShipmentRoute транспортного средства не содержит никакой информации, кроме индекса и метки транспортного средства.

object ( DurationLimit )

Ограничение, применяемое к общей продолжительности маршрута транспортного средства. В заданном OptimizeToursResponse продолжительность маршрута транспортного средства равна разнице между его vehicleEndTime и vehicleStartTime .

object ( DurationLimit )

Ограничение, применяемое к длительности движения транспортного средства по маршруту. В заданном OptimizeToursResponse длительность движения по маршруту равна сумме всех его transitions.travel_duration .

object ( DistanceLimit )

Ограничение применяется к общей дистанции маршрута транспортного средства. В данном OptimizeToursResponse дистанция маршрута представляет собой сумму всех его transitions.travel_distance_meters .

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

Задаёт соответствие строк visitTypes значениям длительности. Длительность — это время, дополнительное к VisitRequest.duration которое учитывается при посещениях с указанными visitTypes . Эта дополнительная длительность посещения увеличивает стоимость, если указано значение costPerHour . Ключи (например, visitTypes ) не могут быть пустыми строками.

Если запрос на посещение имеет несколько типов, для каждого типа на карте будет добавлена ​​длительность.

object ( BreakRule )

Описывает график перерывов, который будет применяться для данного транспортного средства. Если поле пусто, перерывы для данного транспортного средства не будут запланированы.

string

Указывает метку для данного транспортного средства. Эта метка указывается в ответе как vehicleLabel соответствующего ShipmentRoute .

boolean

Если true, usedIfRouteIsEmpty должен быть false, и это транспортное средство останется неиспользованным.

Если отправка выполняется игнорируемым транспортным средством в injectedFirstSolutionRoutes , она пропускается в первом решении, но может быть свободно выполнена в ответе.

Если отправка выполняется игнорируемым транспортным средством в рамках injectedSolutionConstraint , и любой связанный с ним забор/доставка ограничены тем, что остаются на этом транспортном средстве (т.е. не ослаблены до уровня RELAX_ALL_AFTER_THRESHOLD ), она пропускается в ответе. Если у отправки есть непустое поле allowedVehicleIndices и все разрешённые транспортные средства игнорируются, она пропускается в ответе.

number

Указывает мультипликативный коэффициент, который можно использовать для увеличения или уменьшения времени в пути данного транспортного средства. Например, значение 2,0 означает, что данное транспортное средство медленнее и время в пути вдвое больше, чем у стандартных транспортных средств. Этот множитель не влияет на продолжительность поездок. Он влияет на стоимость, если указаны costPerHour или costPerTraveledHour . Значение должно быть в диапазоне [0,001–1000,0]. Если значение не задано, транспортное средство считается стандартным, и этот множитель считается равным 1,0.

ВНИМАНИЕ: Время в пути будет округлено до ближайшей секунды после применения этого множителя, но до выполнения любых числовых операций, поэтому небольшое множитель может привести к потере точности.

См. также extraVisitDurationForVisitType ниже.

boolean

Указывает, следует ли избегать платных дорог, где это целесообразно. Предпочтение будет отдаваться маршрутам, не содержащим платных дорог. Применяется только к транспортным средствам с моторизованным двигателем.

boolean

Указывает, следует ли избегать автомагистралей, где это целесообразно. Предпочтение будет отдано маршрутам, не содержащим автомагистралей. Применяется только к моторизованным видам транспорта.

boolean

Указывает, следует ли избегать паромных переправ, где это целесообразно. Предпочтение будет отдано маршрутам, не включающим паромные переправы. Применяется только к моторизованным видам транспорта.

boolean

Необязательно. Указывает, следует ли избегать навигации внутри помещений, где это целесообразно. Предпочтение будет отдаваться маршрутам, не содержащим навигации внутри помещений. Применимо только к режиму передвижения WALKING .

string ( int64 format)

Мягкое ограничение нагрузки. См. costPerUnitAboveSoftMax .

number

Если загрузка превышает softMaxLoad на маршруте данного транспортного средства, применяется следующий штраф (только один раз для каждого транспортного средства): (загрузка - softMaxLoad ) * costPerUnitAboveSoftMax . Все расходы суммируются и должны быть выражены в тех же единицах, что и Shipment.penalty_cost . Мягкие ограничения можно задать только для типов, которые применяются либо только к самовывозу, либо только к доставке в рамках всей модели.

object ( Interval )

Допустимый интервал загрузки транспортного средства в начале маршрута.

object ( Interval )

Допустимый интервал загрузки транспортного средства в конце маршрута.

string ( int64 format)

Максимально допустимая величина нагрузки.

object ( LoadCost )

Стоимость перемещения одной единицы груза на расстояние одного километра для данного транспортного средства. Это можно использовать в качестве показателя расхода топлива: если груз — это вес (в ньютонах), то нагрузка*километр имеет размерность энергии.

Экспериментальный вариант: более подробную информацию см. на странице https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request .

object ( LoadCost )

Стоимость проезда с единицей груза в течение одного часа для данного транспортного средства.

Экспериментальный вариант: более подробную информацию см. на странице https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request .

string ( int64 format)

Минимально допустимая нагрузка. Должна быть ≥ 0. Если указаны оба значения, min должен быть ≤ max .

string ( int64 format)

Максимально допустимая нагрузка. Должна быть ≥ 0. Если значение не указано, максимальная нагрузка не ограничивается этим сообщением. Если указаны оба значения, min должно быть ≤ max .

string ( int64 format)

Величина груза, при превышении которой стоимость перемещения единицы груза изменяется с costPerUnitBelowThreshold на costPerUnitAboveThreshold. Должна быть >= 0.

number

Стоимость перемещения единицы груза для каждой единицы от 0 до порогового значения. Должна быть конечным значением и >= 0.

number

Cost of moving a unit of load, for each unit above threshold. In the special case threshold = 0, this is a fixed cost per unit. Must be a finite value, and >= 0.

string ( Duration format)

A hard limit constraining the duration to be at most maxDuration.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string ( Duration format)

A soft limit not enforcing a maximum duration limit, but when violated makes the route incur a cost. This cost adds up to other costs defined in the model, with the same unit.

If defined, softMaxDuration must be nonnegative. If maxDuration is also defined, softMaxDuration must be less than maxDuration.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string ( Duration format)

A soft limit not enforcing a maximum duration limit, but when violated makes the route incur a cost, quadratic in the duration. This cost adds up to other costs defined in the model, with the same unit.

If defined, quadraticSoftMaxDuration must be nonnegative. If maxDuration is also defined, quadraticSoftMaxDuration must be less than maxDuration , and the difference must be no larger than one day:

maxDuration - quadraticSoftMaxDuration <= 86400 seconds

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

number

Cost per hour incurred if the softMaxDuration threshold is violated. The additional cost is 0 if the duration is under the threshold, otherwise the cost depends on the duration as follows:

  costPerHourAfterSoftMax * (duration - softMaxDuration)

The cost must be nonnegative.

number

Cost per square hour incurred if the quadraticSoftMaxDuration threshold is violated.

The additional cost is 0 if the duration is under the threshold, otherwise the cost depends on the duration as follows:

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

The cost must be nonnegative.

string ( int64 format)

A hard limit constraining the distance to be at most maxMeters. The limit must be nonnegative.

string ( int64 format)

A soft limit not enforcing a maximum distance limit, but when violated results in a cost which adds up to other costs defined in the model, with the same unit.

If defined softMaxMeters must be less than maxMeters and must be nonnegative.

number

Cost per kilometer incurred, increasing up to softMaxMeters , with formula:

  min(distanceMeters, softMaxMeters) / 1000.0 *
  costPerKilometerBelowSoftMax.

This cost is not supported in routeDistanceLimit .

number

Cost per kilometer incurred if distance is above softMaxMeters limit. The additional cost is 0 if the distance is under the limit, otherwise the formula used to compute the cost is the following:

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

The cost must be nonnegative.

object ( BreakRequest )

Sequence of breaks. See the BreakRequest message.

object ( FrequencyConstraint )

Several FrequencyConstraint may apply. They must all be satisfied by the BreakRequest s of this BreakRule . See FrequencyConstraint .

string ( Timestamp format)

Required. Lower bound (inclusive) on the start of the break.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .

string ( Timestamp format)

Required. Upper bound (inclusive) on the start of the break.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .

string ( Duration format)

Required. Minimum duration of the break. Must be positive.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string ( Duration format)

Required. Minimum break duration for this constraint. Nonnegative. See description of FrequencyConstraint .

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string ( Duration format)

Required. Maximum allowed span of any interval of time in the route that does not include at least partially a break of duration >= minBreakDuration . Must be positive.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

enum ( Type )

The type of the objective.

number

How much this objective should count relatively to the others. This can be any non-negative number, weights do not have to sum to 1. Weights default to 1.0.

object ( Row )

Specifies the rows of the duration and distance matrix. It must have as many elements as ShipmentModel.duration_distance_matrix_src_tags .

string

Tag defining to which vehicles this duration and distance matrix applies. If empty, this applies to all vehicles, and there can only be a single matrix.

Each vehicle start must match exactly one matrix, ie exactly one of their startTags field must match the vehicleStartTag of a matrix (and of that matrix only).

All matrices must have a different vehicleStartTag .

string ( Duration format)

Duration values for a given row. It must have as many elements as ShipmentModel.duration_distance_matrix_dst_tags .

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

number

Distance values for a given row. If no costs or constraints refer to distances in the model, this can be left empty; otherwise it must have as many elements as durations .

string

Tags defining the set of (src->dst) transitions these attributes apply to.

A source visit or vehicle start matches iff its VisitRequest.tags or Vehicle.start_tags either contains srcTag or does not contain excludedSrcTag (depending on which of these two fields is non-empty).

string

See srcTag . Exactly one of srcTag and excludedSrcTag must be non-empty.

string

A destination visit or vehicle end matches iff its VisitRequest.tags or Vehicle.end_tags either contains dstTag or does not contain excludedDstTag (depending on which of these two fields is non-empty).

string

See dstTag . Exactly one of dstTag and excludedDstTag must be non-empty.

number

Specifies a cost for performing this transition. This is in the same unit as all other costs in the model and must not be negative. It is applied on top of all other existing costs.

number

Specifies a cost per kilometer applied to the distance traveled while performing this transition. It adds up to any Vehicle.cost_per_kilometer specified on vehicles.

object ( DistanceLimit )

Specifies a limit on the distance traveled while performing this transition.

As of 2021/06, only soft limits are supported.

string ( Duration format)

Specifies a delay incurred when performing this transition.

This delay always occurs after finishing the source visit and before starting the destination visit.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string

List of incompatible types. Two shipments having different shipment_types among those listed are "incompatible".

enum ( IncompatibilityMode )

Mode applied to the incompatibility.

string

List of alternative shipment types required by the dependentShipmentTypes .

string

All shipments with a type in the dependentShipmentTypes field require at least one shipment of type requiredShipmentTypeAlternatives to be visited on the same route.

NOTE: Chains of requirements such that a shipmentType depends on itself are not allowed.

enum ( RequirementMode )

Mode applied to the requirement.

boolean

Indicates if the "first" event is a delivery.

boolean

Indicates if the "second" event is a delivery.

string ( Duration format)

The offset between the "first" and "second" event. It can be negative.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

integer

Shipment index of the "first" event. This field must be specified.

integer

Shipment index of the "second" event. This field must be specified.