ShipmentModel

string

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

object ( VisitRequest )

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

object ( VisitRequest )

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

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

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

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

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 .

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

string

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

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

string

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

number

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

number

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

boolean

Необязательный. Указывает, что местоположение этой путевой точки предназначено для того, чтобы транспортное средство остановилось на определенной стороне дороги. Если вы установите это значение, маршрут будет проходить через местоположение, так что транспортное средство сможет остановиться на той стороне дороги, к которой местоположение смещено от центра дороги. Эта опция не работает для режима передвижения «ХОДЬБА».

object ( Location )

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

string

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

object ( LatLng )

Географические координаты путевой точки.

integer

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

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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 . Если данный ключ отсутствует на этой карте, соответствующая емкость считается безграничной.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

number

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

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

number

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

number

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

number

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

boolean

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

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

В противном случае он не перемещается от своего начального к конечному местоположению, и для этого транспортного средства не запланировано никаких 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 ) не могут быть пустыми строками.

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

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

object ( BreakRule )

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

string

Указывает метку для этого автомобиля. Эта метка указывается в ответе как vehicleLabel соответствующего ShipmentRoute .

boolean

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

Если отгрузка выполняется игнорируемым транспортным средством в 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 на маршруте этого транспортного средства, применяется следующий штраф (только один раз для каждого транспортного средства): (load - softMaxLoad ) * costPerUnitAboveSoftMax . Все затраты суммируются и должны быть в той же единице измерения, что и Shipment.penalty_cost .

object ( Interval )

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

object ( Interval )

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

string ( int64 format)

Максимально допустимый объем нагрузки.

string ( int64 format)

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

string ( int64 format)

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

string ( Duration format)

Жесткий предел, ограничивающий длительность не более maxDuration.

Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

string ( Duration format)

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

Если определено, softMaxDuration не должно быть отрицательным. Если также определен maxDuration, softMaxDuration должен быть меньше maxDuration.

Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

string ( Duration format)

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

Если определено, quadraticSoftMaxDuration должно быть неотрицательным. Если также определен maxDuration , quadraticSoftMaxDuration должен быть меньше maxDuration , а разница не должна превышать одного дня:

maxDuration - quadraticSoftMaxDuration <= 86400 seconds

Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

number

Стоимость часа, понесенная в случае нарушения порога softMaxDuration . Дополнительная стоимость равна 0, если продолжительность ниже порогового значения, в противном случае стоимость зависит от продолжительности следующим образом:

  costPerHourAfterSoftMax * (duration - softMaxDuration)

Стоимость должна быть неотрицательной.

number

Стоимость квадратного часа, возникающая в случае нарушения quadraticSoftMaxDuration .

Дополнительная стоимость равна 0, если продолжительность ниже порогового значения, в противном случае стоимость зависит от продолжительности следующим образом:

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

Стоимость должна быть неотрицательной.

string ( int64 format)

Жесткий предел, ограничивающий расстояние не более maxMeters. Предел должен быть неотрицательным.

string ( int64 format)

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

Если определено, softMaxMeters должно быть меньше maxMeters и должно быть неотрицательным.

number

Стоимость понесенного километража увеличивается до softMaxMeters по формуле:

  min(distanceMeters, softMaxMeters) / 1000.0 *
  costPerKilometerBelowSoftMax.

Эта стоимость не поддерживается в routeDistanceLimit .

number

Стоимость за километр, если расстояние превышает предел softMaxMeters . Дополнительная стоимость равна 0, если расстояние меньше допустимого, в противном случае для расчета стоимости используется следующая формула:

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

Стоимость должна быть неотрицательной.

object ( BreakRequest )

Последовательность перерывов. См. сообщение BreakRequest .

object ( FrequencyConstraint )

Могут применяться несколько FrequencyConstraint . Все они должны быть удовлетворены BreakRequest этого BreakRule . См. FrequencyConstraint .

string ( Timestamp format)

Необходимый. Нижняя граница (включительно) на начало перерыва.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

Необходимый. Верхняя граница (включительно) на начало перерыва.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Duration format)

Необходимый. Минимальная продолжительность перерыва. Должно быть позитивным.

Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

string ( Duration format)

Необходимый. Минимальная продолжительность перерыва для этого ограничения. Неотрицательный. См. описание FrequencyConstraint .

Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

string ( Duration format)

Необходимый. Максимально допустимый интервал любого интервала времени в маршруте, который не включает хотя бы частично перерыв duration >= minBreakDuration . Должно быть позитивным.

Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

object ( Row )

Указывает ряды матрицы продолжительности и расстояния. У него должно быть столько элементов, сколько и ShipmentModel.duration_distance_matrix_src_tags .

string

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

Каждый старт автомобиля должен соответствовать ровской матрице, то есть, то есть одно из их поля startTags , должно соответствовать vehicleStartTag матрицы (и только этой матрицы).

Все матрицы должны иметь другой vehicleStartTag .

string ( Duration format)

Значения продолжительности для данной строки. У него должно быть столько элементов, сколько и ShipmentModel.duration_distance_matrix_dst_tags .

Продолжительность за секунды с девятью дробными цифрами, заканчивая « s ». Пример: "3.5s" .

number

Значения расстояния для данной строки. Если никакие затраты или ограничения относятся к расстояниям в модели, это можно оставить пустым; В противном случае он должен иметь столько элементов, сколько и durations .

string

Теги, определяющие набор (SRC-> DST) переходов, к этим атрибутам применяется.

Посещение источника или начало транспортного средства совпадает с тем, что его VisitRequest.tags или Vehicle.start_tags либо содержит srcTag , либо не содержит excludedSrcTag (в зависимости от того, какое из этих двух полей не является пустым).

string

Смотрите srcTag . Точно один из srcTag и excludedSrcTag должны быть непустыми.

string

Посещение пункта назначения или конец транспортного средства совпадает с тем, что его VisitRequest.tags или Vehicle.end_tags либо содержит dstTag , либо не содержит excludedDstTag (в зависимости от того, какое из этих двух полей не является пустым).

string

Смотрите dstTag . Точно один из dstTag и excludedDstTag должен быть непустым.

number

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

number

Определяет стоимость за километр, применяемый на расстояние, пройденное при выполнении этого перехода. Это добавляется к любому Vehicle.cost_per_kilometer . Cost_per_kilometer, указанный на транспортных средствах.

object ( DistanceLimit )

Определяет ограничение на расстояние, пройденное во время выполнения этого перехода.

По состоянию на 2021/06 поддерживаются только мягкие пределы.

string ( Duration format)

Указывает задержку, понесенную при выполнении этого перехода.

Эта задержка всегда происходит после завершения посещения источника и перед началом посещения пункта назначения.

Продолжительность за секунды с девятью дробными цифрами, заканчивая « s ». Пример: "3.5s" .

string

Список несовместимых типов. Две отправки, имеющие разные shipment_types среди перечисленных, «несовместимы».

enum ( IncompatibilityMode )

Режим применяется к несовместимости.

string

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

string

Все поставки с типом в области dependentShipmentTypes , по крайней мере, одной партии типа, requiredShipmentTypeAlternatives , которые можно было посетить по одному и тому же маршруту.

ПРИМЕЧАНИЕ. Цепочки требований, так что shipmentType зависит от себя, не допускаются.

enum ( RequirementMode )

Режим применяется к требованию.

boolean

Указывает, является ли «первое» событие доставкой.

boolean

Указывает, является ли событие «второе» доставкой.

string ( Duration format)

Смещение между «первым» и «вторым» событием. Это может быть отрицательным.

Продолжительность за секунды с девятью дробными цифрами, заканчивая « s ». Пример: "3.5s" .

integer

Индекс отправки "первого" события. Это поле должно быть указано.

integer

Индекс отправки "второго" события. Это поле должно быть указано.

string

Пользовательское отображение имени отгрузки. Это может быть до 63 символов в длину и может использовать символы UTF-8.

object ( VisitRequest )

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

object ( VisitRequest )

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

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

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

Объект, содержащий список "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

integer

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

number

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

• Такое же количество элементов, что и costsPerVehicleIndices . costsPerVehicle[i] соответствует costsPerVehicleIndices[i] на транспортное средство.
• такое же количество элементов, что и в модели. Элемент I-TH соответствует транспортному средству #I модели.

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

integer

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

string ( Duration format)

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

Например, пусть t - самое короткое время, необходимое, чтобы перейти из выбранной альтернативы пикапа непосредственно к выбранной альтернативе доставки. Затем установите pickupToDeliveryAbsoluteDetourLimit Searciets:

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 Searciets:

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 .

Объект, содержащий список "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

string

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

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

string

Определяет этикетку для этого VisitRequest . Эта ярлыка сообщается в ответе в качестве visitLabel в соответствующей ShipmentRoute.Visit .

number

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

number

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

boolean

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

object ( Location )

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

string

ID POI Place, связанный с путевой точкой.

object ( LatLng )

Географические координаты путевой точки.

integer

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

string ( Timestamp format)

Трудное время начала окна. Если не указано, это будет установлено на ShipmentModel.global_start_time .

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

Трудное время окончания окна. Если не указано, это будет установлено на ShipmentModel.global_end_time .

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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 )

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

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

costPerHourAfterSoftEndTime и softEndTime могут быть установлены только в том случае, если есть одно временное окно.

object ( TimeWindow )

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

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

costPerHourAfterSoftEndTime и softEndTime могут быть установлены только в том случае, если есть одно временное окно.

enum ( UnloadingPolicy )

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

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

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

Объект, содержащий список "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

number

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

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

number

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

number

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

number

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

boolean

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

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

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

object ( DurationLimit )

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

object ( DurationLimit )

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

object ( DistanceLimit )

Ограничение применяется к общему расстоянию маршрута транспортного средства. В заданном OptimizeToursResponse расстояние маршрута - это сумма всех его transitions.travel_distance_meters .

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

Определяет карту от струн VisitTypes до продолжительности. Продолжительность - visitTypes время в дополнение к VisitRequest.duration . Эта дополнительная продолжительность посещения добавляет стоимость, если указан costPerHour . Ключи (т.е. visitTypes ) не могут быть пустыми струнами.

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

Объект, содержащий список "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

object ( BreakRule )

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

string

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

boolean

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

Если отгрузка выполняется игнорируемым транспортным средством в 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)

A soft limit of the load. See costPerUnitAboveSoftMax .

number

If the load ever exceeds softMaxLoad along this vehicle's route, the following cost penalty applies (only once per vehicle): (load - softMaxLoad ) * costPerUnitAboveSoftMax . All costs add up and must be in the same unit as Shipment.penalty_cost .

object ( Interval )

The acceptable load interval of the vehicle at the start of the route.

object ( Interval )

The acceptable load interval of the vehicle at the end of the route.

string ( int64 format)

The maximum acceptable amount of load.

string ( int64 format)

A minimum acceptable load. Must be ≥ 0. If they're both specified, min must be ≤ max .

string ( int64 format)

A maximum acceptable load. Must be ≥ 0. If unspecified, the maximum load is unrestricted by this message. If they're both specified, min must be ≤ max .

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)

Необходимый. Lower bound (inclusive) on the start of the break.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

Необходимый. Upper bound (inclusive) on the start of the break.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Duration format)

Необходимый. 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)

Необходимый. 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)

Необходимый. 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" .

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.

string

The user-defined display name of the shipment. It can be up to 63 characters long and may use UTF-8 characters.

object ( VisitRequest )

Set of pickup alternatives associated to the shipment. If not specified, the vehicle only needs to visit a location corresponding to the deliveries.

object ( VisitRequest )

Set of delivery alternatives associated to the shipment. If not specified, the vehicle only needs to visit a location corresponding to the pickups.

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

Load demands of the shipment (for example weight, volume, number of pallets etc). The keys in the map should be identifiers describing the type of the corresponding load, ideally also including the units. For example: "weight_kg", "volume_gallons", "pallet_count", etc. If a given key does not appear in the map, the corresponding load is considered as null.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

integer

The set of vehicles that may perform this shipment. If empty, all vehicles may perform it. Vehicles are given by their index in the ShipmentModel 's vehicles list.

number

Specifies the cost that is incurred when this shipment is delivered by each vehicle. If specified, it must have EITHER:

• the same number of elements as costsPerVehicleIndices . costsPerVehicle[i] corresponds to vehicle costsPerVehicleIndices[i] of the model.
• the same number of elements as there are vehicles in the model. The i-th element corresponds to vehicle #i of the model.

These costs must be in the same unit as penaltyCost and must not be negative. Leave this field empty, if there are no such costs.

integer

Indices of the vehicles to which costsPerVehicle applies. If non-empty, it must have the same number of elements as costsPerVehicle . A vehicle index may not be specified more than once. If a vehicle is excluded from costsPerVehicleIndices , its cost is zero.

string ( Duration format)

Specifies the maximum absolute detour time compared to the shortest path from pickup to delivery. If specified, it must be nonnegative, and the shipment must contain at least a pickup and a delivery.

For example, let t be the shortest time taken to go from the selected pickup alternative directly to the selected delivery alternative. Then setting pickupToDeliveryAbsoluteDetourLimit enforces:

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

If both relative and absolute limits are specified on the same shipment, the more constraining limit is used for each possible pickup/delivery pair. As of 2017/10, detours are only supported when travel durations do not depend on vehicles.

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

string ( Duration format)

Specifies the maximum duration from start of pickup to start of delivery of a shipment. If specified, it must be nonnegative, and the shipment must contain at least a pickup and a delivery. This does not depend on which alternatives are selected for pickup and delivery, nor on vehicle speed. This can be specified alongside maximum detour constraints: the solution will respect both specifications.

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

string

Non-empty string specifying a "type" for this shipment. This feature can be used to define incompatibilities or requirements between shipment_types (see shipmentTypeIncompatibilities and shipmentTypeRequirements in ShipmentModel ).

Differs from visitTypes which is specified for a single visit: All pickup/deliveries belonging to the same shipment share the same shipmentType .

string

Specifies a label for this shipment. This label is reported in the response in the shipmentLabel of the corresponding ShipmentRoute.Visit .

boolean

If true, skip this shipment, but don't apply a penaltyCost .

Ignoring a shipment results in a validation error when there are any shipmentTypeRequirements in the model.

Ignoring a shipment that is performed in injectedFirstSolutionRoutes or injectedSolutionConstraint is permitted; the solver removes the related pickup/delivery visits from the performing route. precedenceRules that reference ignored shipments will also be ignored.

number

If the shipment is not completed, this penalty is added to the overall cost of the routes. A shipment is considered completed if one of its pickup and delivery alternatives is visited. The cost may be expressed in the same unit used for all other cost-related fields in the model and must be positive.

IMPORTANT : If this penalty is not specified, it is considered infinite, ie the shipment must be completed.

number

Specifies the maximum relative detour time compared to the shortest path from pickup to delivery. If specified, it must be nonnegative, and the shipment must contain at least a pickup and a delivery.

For example, let t be the shortest time taken to go from the selected pickup alternative directly to the selected delivery alternative. Then setting pickupToDeliveryRelativeDetourLimit enforces:

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

If both relative and absolute limits are specified on the same shipment, the more constraining limit is used for each possible pickup/delivery pair. As of 2017/10, detours are only supported when travel durations do not depend on vehicles.

object ( LatLng )

The geo-location where the vehicle arrives when performing this VisitRequest . If the shipment model has duration distance matrices, arrivalLocation must not be specified.

object ( Waypoint )

The waypoint where the vehicle arrives when performing this VisitRequest . If the shipment model has duration distance matrices, arrivalWaypoint must not be specified.

object ( LatLng )

The geo-location where the vehicle departs after completing this VisitRequest . Can be omitted if it is the same as arrivalLocation . If the shipment model has duration distance matrices, departureLocation must not be specified.

object ( Waypoint )

The waypoint where the vehicle departs after completing this VisitRequest . Can be omitted if it is the same as arrivalWaypoint . If the shipment model has duration distance matrices, departureWaypoint must not be specified.

string

Specifies tags attached to the visit request. Empty or duplicate strings are not allowed.

object ( TimeWindow )

Time windows which constrain the arrival time at a visit. Note that a vehicle may depart outside of the arrival time window, ie arrival time + duration do not need to be inside a time window. This can result in waiting time if the vehicle arrives before TimeWindow.start_time .

The absence of TimeWindow means that the vehicle can perform this visit at any time.

Time windows must be disjoint, ie no time window must overlap with or be adjacent to another, and they must be in increasing order.

costPerHourAfterSoftEndTime and softEndTime can only be set if there is a single time window.

string ( Duration format)

Duration of the visit, ie time spent by the vehicle between arrival and departure (to be added to the possible waiting time; see timeWindows ).

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

number

Cost to service this visit request on a vehicle route. This can be used to pay different costs for each alternative pickup or delivery of a shipment. This cost must be in the same unit as Shipment.penalty_cost and must not be negative.

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

Load demands of this visit request. This is just like Shipment.load_demands field, except that it only applies to this VisitRequest instead of the whole Shipment . The demands listed here are added to the demands listed in Shipment.load_demands .

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

string

Specifies the types of the visit. This may be used to allocate additional time required for a vehicle to complete this visit (see Vehicle.extra_visit_duration_for_visit_type ).

A type can only appear once.

string

Specifies a label for this VisitRequest . This label is reported in the response as visitLabel in the corresponding ShipmentRoute.Visit .

number

The latitude in degrees. It must be in the range [-90.0, +90.0].

number

The longitude in degrees. It must be in the range [-180.0, +180.0].

boolean

Необязательный. Indicates that the location of this waypoint is meant to have a preference for the vehicle to stop at a particular side of road. When you set this value, the route will pass through the location so that the vehicle can stop at the side of road that the location is biased towards from the center of the road. This option doesn't work for the 'WALKING' travel mode.

object ( Location )

A point specified using geographic coordinates, including an optional heading.

string

The POI Place ID associated with the waypoint.

object ( LatLng )

The waypoint's geographic coordinates.

integer

The compass heading associated with the direction of the flow of traffic. This value is used to specify the side of the road to use for pickup and drop-off. Heading values can be from 0 to 360, where 0 specifies a heading of due North, 90 specifies a heading of due East, etc.

string ( Timestamp format)

The hard time window start time. If unspecified it will be set to ShipmentModel.global_start_time .

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

The hard time window end time. If unspecified it will be set to ShipmentModel.global_end_time .

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

The soft start time of the time window.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

The soft end time of the time window.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

number

A cost per hour added to other costs in the model if the event occurs before softStartTime, computed as:

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

This cost must be positive, and the field can only be set if softStartTime has been set.

number

A cost per hour added to other costs in the model if the event occurs after softEndTime , computed as:

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

This cost must be positive, and the field can only be set if softEndTime has been set.

string

The user-defined display name of the vehicle. It can be up to 63 characters long and may use UTF-8 characters.

enum ( TravelMode )

The travel mode which affects the roads usable by the vehicle and its speed. See also travelDurationMultiple .

object ( RouteModifiers )

A set of conditions to satisfy that affect the way routes are calculated for the given vehicle.

object ( LatLng )

Geographic location where the vehicle starts before picking up any shipments. If not specified, the vehicle starts at its first pickup. If the shipment model has duration and distance matrices, startLocation must not be specified.

object ( Waypoint )

Waypoint representing a geographic location where the vehicle starts before picking up any shipments. If neither startWaypoint nor startLocation is specified, the vehicle starts at its first pickup. If the shipment model has duration and distance matrices, startWaypoint must not be specified.

object ( LatLng )

Geographic location where the vehicle ends after it has completed its last VisitRequest . If not specified the vehicle's ShipmentRoute ends immediately when it completes its last VisitRequest . If the shipment model has duration and distance matrices, endLocation must not be specified.

object ( Waypoint )

Waypoint representing a geographic location where the vehicle ends after it has completed its last VisitRequest . If neither endWaypoint nor endLocation is specified, the vehicle's ShipmentRoute ends immediately when it completes its last VisitRequest . If the shipment model has duration and distance matrices, endWaypoint must not be specified.

string

Specifies tags attached to the start of the vehicle's route.

Empty or duplicate strings are not allowed.

string

Specifies tags attached to the end of the vehicle's route.

Empty or duplicate strings are not allowed.

object ( TimeWindow )

Time windows during which the vehicle may depart its start location. They must be within the global time limits (see ShipmentModel.global_* fields). If unspecified, there is no limitation besides those global time limits.

Time windows belonging to the same repeated field must be disjoint, ie no time window can overlap with or be adjacent to another, and they must be in chronological order.

costPerHourAfterSoftEndTime and softEndTime can only be set if there is a single time window.

object ( TimeWindow )

Time windows during which the vehicle may arrive at its end location. They must be within the global time limits (see ShipmentModel.global_* fields). If unspecified, there is no limitation besides those global time limits.

Time windows belonging to the same repeated field must be disjoint, ie no time window can overlap with or be adjacent to another, and they must be in chronological order.

costPerHourAfterSoftEndTime and softEndTime can only be set if there is a single time window.

enum ( UnloadingPolicy )

Unloading policy enforced on the vehicle.

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

Capacities of the vehicle (weight, volume, # of pallets for example). The keys in the map are the identifiers of the type of load, consistent with the keys of the Shipment.load_demands field. If a given key is absent from this map, the corresponding capacity is considered to be limitless.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

number

Vehicle costs: all costs add up and must be in the same unit as Shipment.penalty_cost .

Cost per hour of the vehicle route. This cost is applied to the total time taken by the route, and includes travel time, waiting time, and visit time. Using costPerHour instead of just costPerTraveledHour may result in additional latency.

number

Cost per traveled hour of the vehicle route. This cost is applied only to travel time taken by the route (ie, that reported in ShipmentRoute.transitions ), and excludes waiting time and visit time.

number

Cost per kilometer of the vehicle route. This cost is applied to the distance reported in the ShipmentRoute.transitions and does not apply to any distance implicitly traveled from the arrivalLocation to the departureLocation of a single VisitRequest .

number

Fixed cost applied if this vehicle is used to handle a shipment.

boolean

This field only applies to vehicles when their route does not serve any shipments. It indicates if the vehicle should be considered as used or not in this case.

If true, the vehicle goes from its start to its end location even if it doesn't serve any shipments, and time and distance costs resulting from its start --> end travel are taken into account.

Otherwise, it doesn't travel from its start to its end location, and no breakRule or delay (from TransitionAttributes ) are scheduled for this vehicle. In this case, the vehicle's ShipmentRoute doesn't contain any information except for the vehicle index and label.

object ( DurationLimit )

Limit applied to the total duration of the vehicle's route. In a given OptimizeToursResponse , the route duration of a vehicle is the difference between its vehicleEndTime and vehicleStartTime .

object ( DurationLimit )

Limit applied to the travel duration of the vehicle's route. In a given OptimizeToursResponse , the route travel duration is the sum of all its transitions.travel_duration .

object ( DistanceLimit )

Limit applied to the total distance of the vehicle's route. In a given OptimizeToursResponse , the route distance is the sum of all its transitions.travel_distance_meters .

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

Specifies a map from visitTypes strings to durations. The duration is time in addition to VisitRequest.duration to be taken at visits with the specified visitTypes . This extra visit duration adds cost if costPerHour is specified. Keys (ie visitTypes ) cannot be empty strings.

If a visit request has multiple types, a duration will be added for each type in the map.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

object ( BreakRule )

Describes the break schedule to be enforced on this vehicle. If empty, no breaks will be scheduled for this vehicle.

string

Specifies a label for this vehicle. This label is reported in the response as the vehicleLabel of the corresponding ShipmentRoute .

boolean

If true, usedIfRouteIsEmpty must be false, and this vehicle will remain unused.

If a shipment is performed by an ignored vehicle in injectedFirstSolutionRoutes , it is skipped in the first solution but is free to be performed in the response.

If a shipment is performed by an ignored vehicle in injectedSolutionConstraint and any related pickup/delivery is constrained to remain on the vehicle (ie, not relaxed to level RELAX_ALL_AFTER_THRESHOLD ), it is skipped in the response. If a shipment has a non-empty allowedVehicleIndices field and all of the allowed vehicles are ignored, it is skipped in the response.

number

Specifies a multiplicative factor that can be used to increase or decrease travel times of this vehicle. For example, setting this to 2.0 means that this vehicle is slower and has travel times that are twice what they are for standard vehicles. This multiple does not affect visit durations. It does affect cost if costPerHour or costPerTraveledHour are specified. This must be in the range [0.001, 1000.0]. If unset, the vehicle is standard, and this multiple is considered 1.0.

WARNING: Travel times will be rounded to the nearest second after this multiple is applied but before performing any numerical operations, thus, a small multiple may result in a loss of precision.

See also extraVisitDurationForVisitType below.

boolean

Specifies whether to avoid toll roads where reasonable. Preference will be given to routes not containing toll roads. Applies only to motorized travel modes.

boolean

Specifies whether to avoid highways where reasonable. Preference will be given to routes not containing highways. Applies only to motorized travel modes.

boolean

Specifies whether to avoid ferries where reasonable. Preference will be given to routes not containing travel by ferries. Applies only to motorized travel modes.

boolean

Необязательный. Specifies whether to avoid navigating indoors where reasonable. Preference will be given to routes not containing indoor navigation. Applies only to the WALKING travel mode.

string ( int64 format)

A soft limit of the load. See costPerUnitAboveSoftMax .

number

If the load ever exceeds softMaxLoad along this vehicle's route, the following cost penalty applies (only once per vehicle): (load - softMaxLoad ) * costPerUnitAboveSoftMax . All costs add up and must be in the same unit as Shipment.penalty_cost .