ShipmentModel

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

  • стоимость маршрутизации транспортных средств (сумма затрат за общее время, стоимость за время в пути и фиксированная стоимость для всех транспортных средств).
  • штрафы за невыполненную отгрузку.
  • стоимость глобальной продолжительности поставок
JSON-представление
{
  "shipments": [
    {
      object (Shipment)
    }
  ],
  "vehicles": [
    {
      object (Vehicle)
    }
  ],
  "globalStartTime": string,
  "globalEndTime": string,
  "globalDurationCostPerHour": number,
  "durationDistanceMatrices": [
    {
      object (DurationDistanceMatrix)
    }
  ],
  "durationDistanceMatrixSrcTags": [
    string
  ],
  "durationDistanceMatrixDstTags": [
    string
  ],
  "transitionAttributes": [
    {
      object (TransitionAttributes)
    }
  ],
  "shipmentTypeIncompatibilities": [
    {
      object (ShipmentTypeIncompatibility)
    }
  ],
  "shipmentTypeRequirements": [
    {
      object (ShipmentTypeRequirement)
    }
  ],
  "precedenceRules": [
    {
      object (PrecedenceRule)
    }
  ],
  "maxActiveVehicles": integer
}
Поля
shipments[]

object ( Shipment )

Набор перевозок, которые необходимо выполнить в модели.

vehicles[]

object ( Vehicle )

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

globalStartTime

string ( Timestamp format)

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

Временной интервал модели должен быть меньше года, т. е. globalEndTime и globalStartTime должны отличаться друг от друга в пределах 31536000 секунд.

При использовании полей cost_per_*hour вы можете установить для этого окна меньший интервал, чтобы повысить производительность (например, если вы моделируете один день, вам следует установить глобальные ограничения по времени для этого дня). Если не установлено, по умолчанию используется 00:00:00 UTC, 1 января 1970 года (т. е. секунды: 0, нанос: 0).

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

globalEndTime

string ( Timestamp format)

Если значение не установлено, по умолчанию используется 00:00:00 UTC, 1 января 1971 года (т. е. секунды: 31536000, nanos: 0).

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

globalDurationCostPerHour

number

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

durationDistanceMatrices[]

object ( DurationDistanceMatrix )

Задает матрицы длительности и расстояния, используемые в модели. Если это поле пусто, вместо него будут использоваться Карты Google или геодезические расстояния, в зависимости от значения поля useGeodesicDistances . Если он не пуст, useGeodesicDistances не может быть истинным, и ни durationDistanceMatrixSrcTags , ни durationDistanceMatrixDstTags не могут быть пустыми.

Примеры использования:

  • Есть два местоположения: locA и locB.
  • 1 транспортное средство начинает свой маршрут в locA и заканчивает его в locA.
  • 1 запрос на самовывоз в locB.
model {
  vehicles { startTags: "locA"  endTags: "locA" }
  shipments { pickups { tags: "locB" } }
  durationDistanceMatrixSrcTags: "locA"
  durationDistanceMatrixSrcTags: "locB"
  durationDistanceMatrixDstTags: "locA"
  durationDistanceMatrixDstTags: "locB"
  durationDistanceMatrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}
  • Есть три местоположения: locA, locB и locC.
  • 1 транспортное средство начинает свой маршрут в locA и заканчивает его в locB, используя матрицу «быстро».
  • 1 транспортное средство начинает свой маршрут в locB и заканчивает его в locB, используя матрицу «медленно».
  • 1 транспортное средство начинает свой маршрут в locB и заканчивает его в locB, используя матрицу «быстро».
  • 1 запрос на самовывоз в locC.
model {
  vehicles { startTags: "locA" endTags: "locB" startTags: "fast" }
  vehicles { startTags: "locB" endTags: "locB" startTags: "slow" }
  vehicles { startTags: "locB" endTags: "locB" startTags: "fast" }
  shipments { pickups { tags: "locC" } }
  durationDistanceMatrixSrcTags: "locA"
  durationDistanceMatrixSrcTags: "locB"
  durationDistanceMatrixSrcTags: "locC"
  durationDistanceMatrixDstTags: "locB"
  durationDistanceMatrixDstTags: "locC"
  durationDistanceMatrices {
    vehicleStartTag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  durationDistanceMatrices {
    vehicleStartTag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}
durationDistanceMatrixSrcTags[]

string

Теги, определяющие источники матриц длительности и расстояния; durationDistanceMatrices(i).rows(j) определяет продолжительность и расстояние от посещений с тегом durationDistanceMatrixSrcTags(j) до других посещений в матрице i.

Теги соответствуют VisitRequest.tags или Vehicle.start_tags . Данный VisitRequest или Vehicle должен соответствовать ровно одному тегу в этом поле. Обратите внимание, что теги источника, назначения и матрицы Vehicle могут совпадать; аналогично теги источника и назначения VisitRequest могут совпадать. Все теги должны быть разными и не могут быть пустыми строками. Если это поле не пусто, то и durationDistanceMatrices не должно быть пустым.

durationDistanceMatrixDstTags[]

string

Теги, определяющие назначения матриц длительности и расстояния; durationDistanceMatrices(i).rows(j).durations(k) (соответственно durationDistanceMatrices(i).rows(j).meters(k)) определяет продолжительность (соответственно расстояние) путешествия из посещений с тегом durationDistanceMatrixSrcTags(j) посещениям с тегом durationDistanceMatrixDstTags(k) в матрице i.

Теги соответствуют VisitRequest.tags или Vehicle.start_tags . Данный VisitRequest или Vehicle должен соответствовать ровно одному тегу в этом поле. Обратите внимание, что теги источника, назначения и матрицы Vehicle могут совпадать; аналогично теги источника и назначения VisitRequest могут совпадать. Все теги должны быть разными и не могут быть пустыми строками. Если это поле не пусто, то и durationDistanceMatrices не должно быть пустым.

transitionAttributes[]

object ( TransitionAttributes )

В модель добавлены атрибуты перехода.

shipmentTypeIncompatibilities[]

object ( ShipmentTypeIncompatibility )

Наборы несовместимых типов_доставки (см. ShipmentTypeIncompatibility »).

shipmentTypeRequirements[]

object ( ShipmentTypeRequirement )

Наборы требований shipmentType (см. ShipmentTypeRequirement ).

precedenceRules[]

object ( PrecedenceRule )

Набор правил приоритета, которые должны соблюдаться в модели.

maxActiveVehicles

integer

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

Отгрузка

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

JSON-представление
{
  "displayName": string,
  "pickups": [
    {
      object (VisitRequest)
    }
  ],
  "deliveries": [
    {
      object (VisitRequest)
    }
  ],
  "loadDemands": {
    string: {
      object (Load)
    },
    ...
  },
  "allowedVehicleIndices": [
    integer
  ],
  "costsPerVehicle": [
    number
  ],
  "costsPerVehicleIndices": [
    integer
  ],
  "pickupToDeliveryAbsoluteDetourLimit": string,
  "pickupToDeliveryTimeLimit": string,
  "shipmentType": string,
  "label": string,
  "ignore": boolean,
  "penaltyCost": number,
  "pickupToDeliveryRelativeDetourLimit": number
}
Поля
displayName

string

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

pickups[]

object ( VisitRequest )

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

deliveries[]

object ( VisitRequest )

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

loadDemands

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

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

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

allowedVehicleIndices[]

integer

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

costsPerVehicle[]

number

Указывает затраты, возникающие при доставке груза каждым транспортным средством. Если указано, оно должно иметь ЛИБО:

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

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

costsPerVehicleIndices[]

integer

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

pickupToDeliveryAbsoluteDetourLimit

string ( Duration format)

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

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

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

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

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

pickupToDeliveryTimeLimit

string ( Duration format)

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

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

shipmentType

string

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

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

label

string

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

ignore

boolean

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

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

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

penaltyCost

number

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

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

pickupToDeliveryRelativeDetourLimit

number

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

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

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

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

ПосетитеЗапрос

Запрос на посещение, которое может быть совершено транспортным средством: у него есть географическое местоположение (или два, см. ниже), время открытия и закрытия, представленное временными окнами, и время продолжительности обслуживания (время, проведенное транспортным средством после прибытия забрать или сдать товар).

JSON-представление
{
  "arrivalLocation": {
    object (LatLng)
  },
  "arrivalWaypoint": {
    object (Waypoint)
  },
  "departureLocation": {
    object (LatLng)
  },
  "departureWaypoint": {
    object (Waypoint)
  },
  "tags": [
    string
  ],
  "timeWindows": [
    {
      object (TimeWindow)
    }
  ],
  "duration": string,
  "cost": number,
  "loadDemands": {
    string: {
      object (Load)
    },
    ...
  },
  "visitTypes": [
    string
  ],
  "label": string
}
Поля
arrivalLocation

object ( LatLng )

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

arrivalWaypoint

object ( Waypoint )

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

departureLocation

object ( LatLng )

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

departureWaypoint

object ( Waypoint )

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

tags[]

string

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

timeWindows[]

object ( TimeWindow )

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

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

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

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

duration

string ( Duration format)

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

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

cost

number

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

loadDemands

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

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

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

visitTypes[]

string

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

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

label

string

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

ШиротаДлительность

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

JSON-представление
{
  "latitude": number,
  "longitude": number
}
Поля
latitude

number

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

longitude

number

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

Путевая точка

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

JSON-представление
{
  "sideOfRoad": boolean,

  // Union field location_type can be only one of the following:
  "location": {
    object (Location)
  },
  "placeId": string
  // End of list of possible types for union field location_type.
}
Поля
sideOfRoad

boolean

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

Поле объединения location_type . Различные способы представления местоположения. location_type может быть только одним из следующих:
location

object ( Location )

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

placeId

string

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

Расположение

Инкапсулирует местоположение (географическую точку и необязательный заголовок).

JSON-представление
{
  "latLng": {
    object (LatLng)
  },
  "heading": integer
}
Поля
latLng

object ( LatLng )

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

heading

integer

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

ВремяОкно

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

Жесткие границы временного окна, startTime и endTime , определяют самое раннее и самое позднее время события, например startTime <= event_time <= endTime . Нижняя граница окна мягкого времени, softStartTime , выражает предпочтение тому, чтобы событие произошло в softStartTime или после него, за счет затрат, пропорциональных тому, как долго до softStartTime произойдет событие. Верхняя граница мягкого временного окна softEndTime выражает предпочтение тому, чтобы событие произошло в softEndTime или раньше, за счет затрат, пропорциональных тому, как долго после softEndTime происходит событие. startTime , endTime , softStartTime и softEndTime должны находиться в пределах глобальных ограничений по времени (см. ShipmentModel.global_start_time и ShipmentModel.global_end_time ) и должны учитывать:

  0 <= `startTime` <= `softStartTime` <= `endTime` and
  0 <= `startTime` <= `softEndTime` <= `endTime`.
JSON-представление
{
  "startTime": string,
  "endTime": string,
  "softStartTime": string,
  "softEndTime": string,
  "costPerHourBeforeSoftStartTime": number,
  "costPerHourAfterSoftEndTime": number
}
Поля
startTime

string ( Timestamp format)

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

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

endTime

string ( Timestamp format)

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

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

softStartTime

string ( Timestamp format)

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

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

softEndTime

string ( Timestamp format)

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

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

costPerHourBeforeSoftStartTime

number

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

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

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

costPerHourAfterSoftEndTime

number

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

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

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

Транспортное средство

Моделирует автомобиль в задаче по доставке. При решении проблемы с отправкой будет построен маршрут для этого транспортного средства, начинающийся с startLocation и заканчивающийся endLocation . Маршрут — это последовательность посещений (см. ShipmentRoute ).

JSON-представление
{
  "displayName": string,
  "travelMode": enum (TravelMode),
  "startLocation": {
    object (LatLng)
  },
  "startWaypoint": {
    object (Waypoint)
  },
  "endLocation": {
    object (LatLng)
  },
  "endWaypoint": {
    object (Waypoint)
  },
  "startTags": [
    string
  ],
  "endTags": [
    string
  ],
  "startTimeWindows": [
    {
      object (TimeWindow)
    }
  ],
  "endTimeWindows": [
    {
      object (TimeWindow)
    }
  ],
  "unloadingPolicy": enum (UnloadingPolicy),
  "loadLimits": {
    string: {
      object (LoadLimit)
    },
    ...
  },
  "costPerHour": number,
  "costPerTraveledHour": number,
  "costPerKilometer": number,
  "fixedCost": number,
  "usedIfRouteIsEmpty": boolean,
  "routeDurationLimit": {
    object (DurationLimit)
  },
  "travelDurationLimit": {
    object (DurationLimit)
  },
  "routeDistanceLimit": {
    object (DistanceLimit)
  },
  "extraVisitDurationForVisitType": {
    string: string,
    ...
  },
  "breakRule": {
    object (BreakRule)
  },
  "label": string,
  "ignore": boolean,
  "travelDurationMultiple": number
}
Поля
displayName

string

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

travelMode

enum ( TravelMode )

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

startLocation

object ( LatLng )

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

startWaypoint

object ( Waypoint )

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

endLocation

object ( LatLng )

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

endWaypoint

object ( Waypoint )

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

startTags[]

string

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

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

endTags[]

string

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

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

startTimeWindows[]

object ( TimeWindow )

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

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

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

endTimeWindows[]

object ( TimeWindow )

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

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

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

unloadingPolicy

enum ( UnloadingPolicy )

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

loadLimits

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

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

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

costPerHour

number

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

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

costPerTraveledHour

number

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

costPerKilometer

number

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

fixedCost

number

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

usedIfRouteIsEmpty

boolean

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

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

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

routeDurationLimit

object ( DurationLimit )

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

travelDurationLimit

object ( DurationLimit )

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

routeDistanceLimit

object ( DistanceLimit )

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

extraVisitDurationForVisitType

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

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

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

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

breakRule

object ( BreakRule )

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

label

string

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

ignore

boolean

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

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

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

travelDurationMultiple

number

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

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

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

Режим путешествия

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

Это должно быть подмножество режимов передвижения API-интерфейса «Предпочитаемые маршруты маршрутов платформы Google Карт», см. https://developers.google.com/maps/documentation/routes_preferred/reference/rest/Shared.Types/RouteTravelMode .

Перечисления
TRAVEL_MODE_UNSPECIFIED Неопределенный режим движения, эквивалентный DRIVING .
DRIVING Режим движения, соответствующий направлениям движения (автомобиль, ...).
WALKING Режим движения, соответствующий пешеходным направлениям.

Политика разгрузки

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

Другие перевозки могут осуществляться в любом месте маршрута независимо от unloadingPolicy .

Перечисления
UNLOADING_POLICY_UNSPECIFIED Неопределенная политика разгрузки; поставки должны происходить сразу после их соответствующего получения.
LAST_IN_FIRST_OUT Доставка должна осуществляться в порядке, обратном получению.
FIRST_IN_FIRST_OUT Доставка должна осуществляться в том же порядке, что и самовывоз.

Ограничение нагрузки

Определяет предельную нагрузку, применимую к транспортному средству, например: «Этот грузовик может перевозить не более 3500 кг». См. loadLimits .

JSON-представление
{
  "softMaxLoad": string,
  "costPerUnitAboveSoftMax": number,
  "startLoadInterval": {
    object (Interval)
  },
  "endLoadInterval": {
    object (Interval)
  },
  "maxLoad": string
}
Поля
softMaxLoad

string ( int64 format)

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

costPerUnitAboveSoftMax

number

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

startLoadInterval

object ( Interval )

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

endLoadInterval

object ( Interval )

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

maxLoad

string ( int64 format)

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

Интервал

Интервал допустимых объемов нагрузки.

JSON-представление
{
  "min": string,
  "max": string
}
Поля
min

string ( int64 format)

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

max

string ( int64 format)

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

Ограничение продолжительности

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

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

JSON-представление
{
  "maxDuration": string,
  "softMaxDuration": string,
  "quadraticSoftMaxDuration": string,
  "costPerHourAfterSoftMax": number,
  "costPerSquareHourAfterQuadraticSoftMax": number
}
Поля
maxDuration

string ( Duration format)

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

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

softMaxDuration

string ( Duration format)

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

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

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

quadraticSoftMaxDuration

string ( Duration format)

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

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

maxDuration - quadraticSoftMaxDuration <= 86400 seconds

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

costPerHourAfterSoftMax

number

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

  costPerHourAfterSoftMax * (duration - softMaxDuration)

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

costPerSquareHourAfterQuadraticSoftMax

number

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

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

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

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

Предел расстояния

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

Если определен мягкий предел, как softMaxMeters , так и costPerKilometerAboveSoftMax должны быть определены и быть неотрицательными.

JSON-представление
{
  "maxMeters": string,
  "softMaxMeters": string,
  "costPerKilometerAboveSoftMax": number
}
Поля
maxMeters

string ( int64 format)

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

softMaxMeters

string ( int64 format)

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

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

costPerKilometerAboveSoftMax

number

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

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

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

BreakRule

Правила создания временных перерывов для транспортного средства (например, перерывы на обед). Перерыв — это непрерывный период времени, в течение которого транспортное средство простаивает на своем текущем месте и не может совершить ни одного визита. Обрыв может произойти:

  • во время путешествия между двумя посещениями (включая время непосредственно перед или сразу после посещения, но не в середине посещения), и в этом случае продлевается соответствующее транзитное время между посещениями,
  • или перед запуском автомобиля (автомобиль может не завестись в середине перерыва), в этом случае это не влияет на время запуска автомобиля.
  • или после окончания транспортного средства (то же самое, со временем окончания транспортного средства).
JSON-представление
{
  "breakRequests": [
    {
      object (BreakRequest)
    }
  ],
  "frequencyConstraints": [
    {
      object (FrequencyConstraint)
    }
  ]
}
Поля
breakRequests[]

object ( BreakRequest )

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

frequencyConstraints[]

object ( FrequencyConstraint )

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

Запрос на перерыв

Последовательность перерывов (т.е. их количество и порядок), применимых к каждому транспортному средству, должна быть известна заранее. Повторяющиеся BreakRequest определяют эту последовательность в том порядке, в котором они должны происходить. Их временные окна ( earliestStartTime / latestStartTime ) могут перекрываться, но они должны быть совместимы с порядком (это отмечено).

JSON-представление
{
  "earliestStartTime": string,
  "latestStartTime": string,
  "minDuration": string
}
Поля
earliestStartTime

string ( Timestamp format)

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

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

latestStartTime

string ( Timestamp format)

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

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

minDuration

string ( Duration format)

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

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

Частотное ограничение

Можно дополнительно ограничить частоту и продолжительность перерывов, указанных выше, установив минимальную частоту перерывов, например: «Перерыв должен быть не менее 1 часа каждые 12 часов». Предполагая, что это можно интерпретировать как «в любое время скользящего времени 12 часов, должен быть как минимум один разрыв, по крайней мере, один час», этот пример будет переведен в следующую FrequencyConstraint :

{
   minBreakDuration { seconds: 3600 }         # 1 hour.
   maxInterBreakDuration { seconds: 39600 }  # 11 hours (12 - 1 = 11).
}

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

FrequencyConstraint может на практике применить к неконтролирующим перерывам. Например, в следующем графике приведен пример «1 ч каждые 12 часов»:

  04:00 vehicle start
   .. performing travel and visits ..
  09:00 1 hour break
  10:00 end of the break
   .. performing travel and visits ..
  12:00 20-min lunch break
  12:20 end of the break
   .. performing travel and visits ..
  21:00 1 hour break
  22:00 end of the break
   .. performing travel and visits ..
  23:59 vehicle end
Представление JSON
{
  "minBreakDuration": string,
  "maxInterBreakDuration": string
}
Поля
minBreakDuration

string ( Duration format)

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

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

maxInterBreakDuration

string ( Duration format)

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

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

DurationDistanceMatrix

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

Представление JSON
{
  "rows": [
    {
      object (Row)
    }
  ],
  "vehicleStartTag": string
}
Поля
rows[]

object ( Row )

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

vehicleStartTag

string

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

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

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

Ряд

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

Представление JSON
{
  "durations": [
    string
  ],
  "meters": [
    number
  ]
}
Поля
durations[]

string ( Duration format)

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

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

meters[]

number

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

Transitionattributes

Определяет атрибуты переходов между двумя последовательными посещениями по маршруту. Несколько TransitionAttributes могут применяться к одному и тому же переходу: в этом случае все дополнительные затраты увеличиваются, и применяется строгое ограничение или ограничение (после естественной »и« семантики).

Представление JSON
{
  "srcTag": string,
  "excludedSrcTag": string,
  "dstTag": string,
  "excludedDstTag": string,
  "cost": number,
  "costPerKilometer": number,
  "distanceLimit": {
    object (DistanceLimit)
  },
  "delay": string
}
Поля
srcTag

string

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

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

excludedSrcTag

string

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

dstTag

string

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

excludedDstTag

string

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

cost

number

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

costPerKilometer

number

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

distanceLimit

object ( DistanceLimit )

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

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

delay

string ( Duration format)

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

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

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

Отгрузка

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

Представление JSON
{
  "types": [
    string
  ],
  "incompatibilityMode": enum (IncompatibilityMode)
}
Поля
types[]

string

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

incompatibilityMode

enum ( IncompatibilityMode )

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

Несовместимость

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

Перечисления
INCOMPATIBILITY_MODE_UNSPECIFIED Неуказанный режим несовместимости. Это значение никогда не должно использоваться.
NOT_PERFORMED_BY_SAME_VEHICLE В этом режиме две поставки с несовместимыми типами никогда не могут разделить один и тот же автомобиль.
NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY

Для двух поставок с несовместимыми типами с помощью режима несовместимости NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY несовместимость:

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

Отгрузка

Указывает требования между поставками на основе их отгрузки. Специфика требования определяется режимом требований.

Представление JSON
{
  "requiredShipmentTypeAlternatives": [
    string
  ],
  "dependentShipmentTypes": [
    string
  ],
  "requirementMode": enum (RequirementMode)
}
Поля
requiredShipmentTypeAlternatives[]

string

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

dependentShipmentTypes[]

string

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

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

requirementMode

enum ( RequirementMode )

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

Требование

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

Перечисления
REQUIREMENT_MODE_UNSPECIFIED Неуказанный режим требования. Это значение никогда не должно использоваться.
PERFORMED_BY_SAME_VEHICLE В этом режиме все «зависимые» поставки должны иметь то же автомобиль, что и по крайней мере одна из их «требуемых» поставки.
IN_SAME_VEHICLE_AT_PICKUP_TIME

В режиме IN_SAME_VEHICLE_AT_PICKUP_TIME все «зависимые» поставки должны иметь по крайней мере одну «требуемую» отгрузку на своем транспортном средстве во время их выбора.

Таким образом, «зависимый» выписка должен иметь либо:

  • Только доставка «требуется», доставленная по маршруту после, или
  • «Требуемая» отгрузка, поднятая на маршруте перед ним, и если «требуемая» отправка имеет доставку, эта доставка должна выполняться после получения «зависимой» отгрузки.
IN_SAME_VEHICLE_AT_DELIVERY_TIME То же, что и раньше, за исключением того, что «зависимые» поставки должны иметь «обязательную» отправку на их транспортное средство во время их доставки .

Предшествующий

Правило приоритета между двумя событиями (каждое событие - это пикап или доставка отгрузки): событие «Второе» должно начать, по крайней мере, offsetDuration после начала «первого».

Несколько предложений могут ссылаться на те же (или связанные) события, например, «пикап B происходит после доставки« и «пикап C происходит после пикапа B».

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

Представление JSON
{
  "firstIsDelivery": boolean,
  "secondIsDelivery": boolean,
  "offsetDuration": string,
  "firstIndex": integer,
  "secondIndex": integer
}
Поля
firstIsDelivery

boolean

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

secondIsDelivery

boolean

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

offsetDuration

string ( Duration format)

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

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

firstIndex

integer

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

secondIndex

integer

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