ShipmentModel

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

  • стоимость маршрутизации транспортных средств (сумма затрат за общее время, стоимость за время в пути и фиксированная стоимость для всех транспортных средств).
  • штрафы за невыполненную отгрузку.
  • стоимость глобальной продолжительности поставок
JSON-представление 
{
  "shipments": [
    {
      object (Shipment)
    }
  ],
  "vehicles": [
    {
      object (Vehicle)
    }
  ],
  "objectives": [
    {
      object (Objective)
    }
  ],
  "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 )

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

objectives[]

object ( Objective )

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

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

globalStartTime

string ( Timestamp format)

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

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

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

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

globalEndTime

string ( Timestamp format)

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

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

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

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

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,
  "avoidUTurns": boolean
}
Поля
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 .

visitTypes[]

string

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

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

label

string

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

avoidUTurns

boolean

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

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

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

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

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

number

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

longitude

number

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

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

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

JSON-представление 
{
  "sideOfRoad": boolean,
  "vehicleStopover": 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

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

vehicleStopover

boolean

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

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

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

object ( Location )

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

placeId

string

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

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

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

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

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

string ( Timestamp format)

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

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

endTime

string ( Timestamp format)

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

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

softStartTime

string ( Timestamp format)

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

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

softEndTime

string ( Timestamp format)

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

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

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),
  "routeModifiers": {
    object (RouteModifiers)
  },
  "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 .

routeModifiers

object ( RouteModifiers )

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

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

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 ) не могут быть пустыми строками.

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

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 Maps, см. https://developers.google.com/maps/documentation/routes/reference/rest/v2/RouteTravelMode .

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

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

Модификаторы маршрута

Инкапсулирует набор дополнительных условий, которые необходимо выполнить при расчете маршрутов транспортных средств. Это похоже на RouteModifiers в предпочтительном API маршрутов платформы Google Maps; см.: https://developers.google.com/maps/documentation/routes/reference/rest/v2/RouteModifiers .

JSON-представление 
{
  "avoidTolls": boolean,
  "avoidHighways": boolean,
  "avoidFerries": boolean,
  "avoidIndoor": boolean
}
Поля
avoidTolls

boolean

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

avoidHighways

boolean

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

avoidFerries

boolean

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

avoidIndoor

boolean

Необязательный. Указывает, следует ли избегать навигации в помещении, где это возможно. Предпочтение будет отдано маршрутам, не содержащим внутренней навигации. Применимо только к режиму движения 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,
  "costPerKilometer": {
    object (LoadCost)
  },
  "costPerTraveledHour": {
    object (LoadCost)
  }
}
Поля
softMaxLoad

string ( int64 format)

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

costPerUnitAboveSoftMax

number

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

startLoadInterval

object ( Interval )

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

endLoadInterval

object ( Interval )

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

maxLoad

string ( int64 format)

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

costPerKilometer

object ( LoadCost )

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

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

costPerTraveledHour

object ( LoadCost )

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

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

Интервал

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

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

string ( int64 format)

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

max

string ( int64 format)

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

Лоадкост

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

  • min(load, loadThreshold ) * costPerUnitBelowThreshold
  • max(0, load - loadThreshold ) * costPerUnitAboveThreshold

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

load_limit {
  key: "weight"
  value {
    costPerKilometer {
      loadThreshold: 15
      costPerUnitBelowThreshold: 2.0
      costPerUnitAboveThreshold: 10.0
    }
  }
}

и его маршрут — начало, пикап, пикап, доставка, доставка, конец с переходами: 

transition { vehicle_load['weight'] { amount: 0 }
             travelDistanceMeters: 1000.0 }
transition { vehicle_load['weight'] { amount: 10 }
             travelDistanceMeters: 1000.0 }
transition { vehicle_load['weight'] { amount: 20 }
             travelDistanceMeters: 1000.0 }
transition { vehicle_load['weight'] { amount: 10 }
             travelDistanceMeters: 1000.0 }
transition { vehicle_load['weight'] { amount: 0 }
             travelDistanceMeters: 1000.0 }

тогда стоимость, понесенная этой LoadCost , равна (стоимость_ниже * нагрузка_ниже * километры + стоимость_выше * нагрузка_выше * км)

  • переход 0:0,0
  • переход 1: 2,0*10*1,0 + 10,0*0*1,0 = 20,0
  • переход 2: 2,0*15*1,0+10,0*(20 - 15)*1,0 = 80,0
  • переход 3: 2,0*10*1,0 + 10,0*0*1,0 = 20,0
  • переход 4: 0,0

Таким образом, LoadCost по маршруту составляет 120,0.

Однако, если маршрут начинается,самовывоз,доставка,самовывоз,доставка,конец с переходами: 

transition { vehicle_load['weight'] { amount: 0 }
             travelDistanceMeters: 1000.0 }
transition { vehicle_load['weight'] { amount: 10 }
             travelDistanceMeters: 1000.0 }
transition { vehicle_load['weight'] { amount: 0 }
             travelDistanceMeters: 1000.0 }
transition { vehicle_load['weight'] { amount: 10 }
             travelDistanceMeters: 1000.0 }
transition { vehicle_load['weight'] { amount: 0 }
             travelDistanceMeters: 1000.0 }

тогда стоимость, понесенная этим LoadCost равна

  • переход 0:0,0
  • переход 1: 2,0*10*1,0 + 10,0*0*1,0 = 20,0
  • переход 2: 0,0
  • переход 3: 2,0*10*1,0 + 10,0*0*1,0 = 20,0
  • переход 4: 0,0

Здесь LoadCost по маршруту равен 40,0.

LoadCost делает решения с тяжелыми переходами более дорогими.

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

JSON-представление 
{
  "loadThreshold": string,
  "costPerUnitBelowThreshold": number,
  "costPerUnitAboveThreshold": number
}
Поля
loadThreshold

string ( int64 format)

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

costPerUnitBelowThreshold

number

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

costPerUnitAboveThreshold

number

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

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

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

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

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

string ( Duration format)

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

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

softMaxDuration

string ( Duration format)

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

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

Продолжительность за секунды с девятью дробными цифрами, заканчивая « 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

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

Distancelimit

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

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

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

string ( int64 format)

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

softMaxMeters

string ( int64 format)

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

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

costPerKilometerBelowSoftMax

number

Стоимость за километр, увеличиваясь до softMaxMeters , с формулой: 

  min(distanceMeters, softMaxMeters) / 1000.0 *
  costPerKilometerBelowSoftMax.

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

costPerKilometerAboveSoftMax

number

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

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

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

Разрыв

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

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

object ( BreakRequest )

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

frequencyConstraints[]

object ( FrequencyConstraint )

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

Breakrequest

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

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

string ( Timestamp format)

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

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

latestStartTime

string ( Timestamp format)

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

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

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

Цель

Цели полностью заменяют модель затрат и, следовательно, несовместимы с ранее существовавшими затратами. Каждая цель отображает ряд заранее определенных затрат на, например, транспортные средства, поставки или атрибуты перехода.

Экспериментальный: см. Https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request для получения более подробной информации.

JSON-представление 
{
  "type": enum (Type),
  "weight": number
}
Поля
type

enum ( Type )

Тип цели.

weight

number

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

Тип

Целевой тип, который будет сопоставлен с набором затрат.

Перечисления
DEFAULT Будет использован набор затрат по умолчанию, чтобы обеспечить разумное решение. ПРИМЕЧАНИЕ. Эта цель может использоваться самостоятельно, но также всегда будет добавлено с весом 1.0, в качестве базовой линии, к целям, указанным пользователем, если она еще не присутствует.
MIN_DISTANCE «Мин» Цели. Минимизируйте общее пройденное расстояние.
MIN_WORKING_TIME Минимизируйте общее рабочее время, суммируется над всеми транспортными средствами.
MIN_TRAVEL_TIME То же, что и выше, но сосредоточившись только на времени в пути.
MIN_NUM_VEHICLES Минимизируйте количество используемых транспортных средств.

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

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