Package google.maps.routeoptimization.v1

int32

Количество выполненных доставок. Обратите внимание, что пара «забор-доставка» учитывается только один раз.

Duration

Общая продолжительность пути по маршруту или решению.

Duration

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

Duration

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

Duration

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

Duration

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

Duration

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

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

Общее расстояние прохождения маршрута или решения.

map<string, VehicleLoad >

Максимальная загрузка, достигнутая на всем маршруте (соответственно решение), для каждого из количеств на этом маршруте (соответственно решение), вычисленная как максимум по всем Transition.vehicle_loads (соответственно ShipmentRoute.metrics.max_loads .

int32

Количество выполненных обязательных отгрузок.

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

double

Сумма Shipment.penalty_cost выполненных перевозок.

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

string

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

Формат:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

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

AsyncModelConfig

Обязательно. Входная/выходная информация для каждой модели покупки, например, пути к файлам и форматы данных.

string

Необязательно. Имя модели, определяемое пользователем, может использоваться пользователями в качестве псевдонима для отслеживания моделей.

InputConfig

Обязательно. Информация о входной модели.

OutputConfig

Обязательно. Требуемая информация о местоположении выходных данных.

BreakRequest

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

FrequencyConstraint

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

Timestamp

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

Timestamp

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

Duration

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

Duration

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

Duration

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

int64

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

int64

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

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

double

Стоимость за километр пробега увеличивается до soft_max_meters по формуле:

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

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

double

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

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

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

string

Обязательно. URI облачного хранилища Google.

string

Обязательно. URI объекта Google Cloud Storage в формате gs://bucket/path/to/object .

ShipmentRoute

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

SkippedShipment

Пропущенные поставки раствора для инъекций. Некоторые партии могли быть исключены из исходного раствора. См. поле routes .

ConstraintRelaxation

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

Relaxation

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

int32

Specifies the vehicle indices to which the visit constraint relaxations apply. If empty, this is considered the default and the relaxations apply to all vehicles that are not specified in other constraint_relaxations . There can be at most one default, ie, at most one constraint relaxation field is allowed empty vehicle_indices . A vehicle index can only be listed once, even within several constraint_relaxations .

Индекс транспортного средства сопоставляется так же, как ShipmentRoute.vehicle_index , если interpret_injected_solutions_using_labels имеет значение true (см. комментарий к fields ).

Level

Уровень ослабления ограничений, который применяется, когда выполняются условия на threshold_time или после него И по крайней мере threshold_visit_count .

Timestamp

Время, в течение которого или после которого может быть применен level релаксации.

int32

Количество посещений, при достижении или после которого может быть применен level релаксации. Если threshold_visit_count равен 0 (или не установлен), level может быть применен непосредственно при запуске транспортного средства.

Если значение равно route.visits_size() + 1 , level может быть применён только к концу транспортного средства. Если значение больше route.visits_size() + 1 , level не применяется к данному маршруту вообще.

DataFormat

Обязательно. Формат входных данных.

GcsSource

Место хранения в облачном хранилище Google. Это должен быть один объект (файл).

LatLng

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

int32

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

string

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

Формат:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

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

Duration

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

Для асинхронных запросов сервер сгенерирует решение (если это возможно) до истечения времени ожидания.

ShipmentModel

Решить модель отгрузки.

SolvingMode

По умолчанию режим решения — DEFAULT_SOLVE (0).

SearchMode

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

ShipmentRoute

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

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

Решение должно удовлетворять некоторым основным предположениям о достоверности:

• для всех маршрутов vehicle_index должен находиться в допустимом диапазоне и не дублироваться.
• для всех посещений shipment_index и visit_request_index должны находиться в допустимом диапазоне.
• одна отправка может быть указана только на одном маршруте.
• забор груза, подлежащего доставке самовывозом, должен быть осуществлен до доставки.
• допускается не более одного варианта самовывоза или доставки отправления.
• для всех маршрутов время увеличивается (т.е. vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time ).
• Перевозка может быть осуществлена ​​только на разрешенном транспортном средстве. Транспортное средство разрешено, если Shipment.allowed_vehicle_indices пусто или его vehicle_index включен в Shipment.allowed_vehicle_indices .

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

InjectedSolutionConstraint

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

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

ShipmentRoute

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

Начиная с 2020/11 года при этом заполняются только полилинии непустых маршрутов и требуется, чтобы populate_polylines имело значение true.

Поля route_polyline переданных маршрутов могут не соответствовать transitions маршрутов.

Это поле нельзя использовать вместе с injected_first_solution_routes или injected_solution_constraint .

Shipment.ignore и Vehicle.ignore не влияют на поведение. Ломаные линии по-прежнему заполняются между всеми посещениями на всех непустых маршрутах, независимо от того, игнорируются ли соответствующие грузы или транспортные средства.

bool

Если верно:

• uses ShipmentRoute.vehicle_label instead of vehicle_index to match routes in an injected solution with vehicles in the request; reuses the mapping of original ShipmentRoute.vehicle_index to new ShipmentRoute.vehicle_index to update ConstraintRelaxation.vehicle_indices if non-empty, but the mapping must be unambiguous (ie, multiple ShipmentRoute s must not share the same original vehicle_index ).
• использует ShipmentRoute.Visit.shipment_label вместо shipment_index для сопоставления посещений во внедренном решении с отправками в запросе;
• использует SkippedShipment.label вместо SkippedShipment.index для сопоставления пропущенных поставок во внедренном решении с запрошенными поставками.

Эта интерпретация применяется к полям injected_first_solution_routes , injected_solution_constraint и refresh_details_routes . Её можно использовать, если индексы отправлений или транспортных средств в запросе изменились с момента создания решения, например, из-за удаления или добавления отправлений или транспортных средств из запроса.

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

• Vehicle.label в запросе;
• Shipment.label в запросе;
• ShipmentRoute.vehicle_label в введенном растворе;
• SkippedShipment.label и ShipmentRoute.Visit.shipment_label в введенном решении (за исключением пар посещений «забор/доставка», в которых shipment_label должен появляться дважды).

If a vehicle_label in the injected solution does not correspond to a request vehicle, the corresponding route is removed from the solution along with its visits. If a shipment_label in the injected solution does not correspond to a request shipment, the corresponding visit is removed from the solution. If a SkippedShipment.label in the injected solution does not correspond to a request shipment, the SkippedShipment is removed from the solution.

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

NOTE: The caller must ensure that each Vehicle.label (resp. Shipment.label ) uniquely identifies a vehicle (resp. shipment) entity used across the two relevant requests: the past request that produced the OptimizeToursResponse used in the injected solution and the current request that includes the injected solution. The uniqueness checks described above are not enough to guarantee this requirement.

bool

Учитывайте оценку трафика при расчете полей ShipmentRoute Transition.travel_duration , Visit.start_time и vehicle_end_time , при настройке поля ShipmentRoute.has_traffic_infeasibilities и при расчете поля OptimizeToursResponse.total_cost .

bool

Если true, полилинии будут заполнены в ответе ShipmentRoute s.

bool

Если значение равно true, полилинии и маркеры маршрута будут заполнены в ответе ShipmentRoute.transitions .

bool

Если этот параметр установлен, запрос может иметь срок выполнения (см. https://grpc.io/blog/deadlines ) до 60 минут. В противном случае максимальный срок составляет всего 30 минут. Обратите внимание, что для длительных запросов риск прерывания значительно выше (хотя и невелик).

bool

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

string

Метка, которая может использоваться для идентификации этого запроса, возвращается в OptimizeToursResponse.request_label .

double

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

int32

Усекает количество возвращаемых ошибок валидации. Эти ошибки обычно прикрепляются к полезной нагрузке ошибки INVALID_ARGUMENT в виде сведений об ошибке BadRequest ( https://cloud.google.com/apis/design/errors#error_details) , если не задан параметр solved_mode=VALIDATE_ONLY: см. поле OptimizeToursResponse.validation_errors . Значение по умолчанию — 100, ограничение — 10 000.

ShipmentRoute

Маршруты рассчитаны для каждого транспортного средства; i-й маршрут соответствует i-му транспортному средству в модели.

string

Копия OptimizeToursRequest.label , если метка была указана в запросе.

SkippedShipment

Список всех пропущенных поставок.

OptimizeToursValidationError

Список всех ошибок валидации, которые нам удалось обнаружить независимо. См. пояснение к сообщению OptimizeToursValidationError в разделе «МНОЖЕСТВЕННЫЕ ОШИБКИ». Вместо ошибок будут выведены предупреждения, если solving_mode — DEFAULT_SOLVE .

OptimizeToursRequest

В некоторых случаях мы изменяем входящий запрос перед его решением, то есть добавляем стоимость. Если solved_mode == TRANSFORM_AND_RETURN_REQUEST, изменённый запрос возвращается сюда.

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

Metrics

Показатели продолжительности, расстояния и использования для этого решения.

AggregatedMetrics

Агрегируется по маршрутам. Каждая метрика представляет собой сумму (или максимальное значение для грузов) всех полей ShipmentRoute.metrics с одинаковым именем.

int32

Количество пропущенных обязательных поставок.

int32

Количество использованных транспортных средств. Примечание: если маршрут транспортного средства пуст и Vehicle.used_if_route_is_empty имеет значение true, транспортное средство считается использованным.

Timestamp

Самое раннее время начала движения подержанного транспортного средства, рассчитанное как минимум по всем подержанным транспортным средствам ShipmentRoute.vehicle_start_time .

Timestamp

Самое позднее время окончания для подержанного транспортного средства, рассчитанное как максимальное значение для всех подержанных транспортных средств ShipmentRoute.vehicle_end_time .

map<string, double>

Cost of the solution, broken down by cost-related request fields. The keys are proto paths, relative to the input OptimizeToursRequest, eg "model.shipments.pickups.cost", and the values are the total cost generated by the corresponding cost field, aggregated over the whole solution. In other words, costs["model.shipments.pickups.cost"] is the sum of all pickup costs over the solution. All costs defined in the model are reported in detail here with the exception of costs related to TransitionAttributes that are only reported in an aggregated way as of 2022/01.

double

Общая стоимость решения. Сумма всех значений на карте затрат.

string

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

Формат:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

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

Uri

Обязательно. URI объекта облачного хранилища, содержащего OptimizeToursRequest .

Uri

Обязательно. URI объекта облачного хранилища, который будет содержать OptimizeToursResponse .

Uri

Необязательно. URI объекта облачного хранилища, содержащего OptimizeToursResponse закодированный в формате JSON или textproto. Если объект закодирован в формате JSON, расширение имени объекта будет .json . Если объект закодирован в формате textproto, расширение имени объекта будет .txtpb .

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

int32

Ошибка проверки определяется парой ( code , display_name ), которая всегда присутствует.

Поля, следующие за этим разделом, предоставляют более подробную информацию об ошибке.

MULTIPLE ERRORS : When there are multiple errors, the validation process tries to output several of them. Much like a compiler, this is an imperfect process. Some validation errors will be "fatal", meaning that they stop the entire validation process. This is the case for display_name="UNSPECIFIED" errors, among others. Some errors may cause the validation process to skip other errors.

СТАБИЛЬНОСТЬ : code и display_name должны быть очень стабильными. Однако со временем могут появляться новые коды и display_name, что может привести к тому, что заданный (неверный) запрос вернет другую пару ( code , display_name ), поскольку новая ошибка скроет старую. Например, см. раздел «МНОЖЕСТВЕННЫЕ ОШИБКИ».

string

Отображаемое имя ошибки.

FieldReference

Контекст ошибки может включать 0, 1 (чаще всего) или более полей. Например, ссылку на транспортное средство №4 и первый забор груза №2 можно реализовать следующим образом:

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 sub_field {name: "pickups" index: 0} }

Однако следует отметить, что количество fields не должно меняться для данного кода ошибки.

string

Строка, описывающая ошибку, понятная человеку. Между code и error_message существует соответствие 1:1 (когда код != "НЕ УКАЗАНО").

СТАБИЛЬНОСТЬ : Нестабильно: сообщение об ошибке, связанное с данным code может со временем меняться (надеюсь, для большей ясности). Вместо этого ориентируйтесь на display_name и code .

string

Может содержать значение(я) поля(ей). Эта информация доступна не всегда. Ни в коем случае не следует полагаться на неё и использовать только для ручной отладки модели.

string

Название поля, например, «транспортные средства».

FieldReference

Рекурсивно вложенное подполе, если необходимо.

int32

Индекс поля, если повторяется.

string

Ключ, если поле представляет собой карту.

DataFormat

Обязательно. Формат выходных данных.

GcsDestination

The Google Cloud Storage location to write the output to.

bool

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

bool

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

bool

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

bool

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

string

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

VisitRequest

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

VisitRequest

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

map<string, Load >

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

int32

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

double

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

• the same number of elements as costs_per_vehicle_indices . costs_per_vehicle[i] corresponds to vehicle costs_per_vehicle_indices[i] of the model.
• Число элементов равно числу транспортных средств в модели. i-й элемент соответствует транспортному средству № i в модели.

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

int32

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

Duration

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

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

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

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

Duration

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

string

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

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

string

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

bool

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

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

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

double

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

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

double

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

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

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

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

int64

The amount by which the load of the vehicle performing the corresponding visit will vary. Since it is an integer, users are advised to choose an appropriate unit to avoid loss of precision. Must be ≥ 0.

LatLng

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

Waypoint

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

LatLng

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

Waypoint

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

string

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

TimeWindow

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

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

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

cost_per_hour_after_soft_end_time and soft_end_time can only be set if there is a single time window.

Duration

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

double

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

map<string, Load >

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

string

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

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

string

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

bool

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

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

Shipment

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

Vehicle

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

Objective

The set of objectives for this model, that we will transform into costs. If not empty, the input model has to be costless. To obtain the modified request, please use solving_mode = TRANSFORM_AND_RETURN_REQUEST. Note that the request will not be solved in this case. See corresponding documentation.

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

Timestamp

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

The model's time span must be less than a year, ie the global_end_time and the global_start_time must be within 31536000 seconds of each other.

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

Timestamp

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

double

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

DurationDistanceMatrix

Specifies duration and distance matrices used in the model. If this field is empty, Google Maps or geodesic distances will be used instead, depending on the value of the use_geodesic_distances field. If it is not empty, use_geodesic_distances cannot be true and neither duration_distance_matrix_src_tags nor duration_distance_matrix_dst_tags can be empty.

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

• Существует два местоположения: locA и locB.
• 1 транспортное средство начинает свой маршрут в locA и заканчивает его в locA.
• 1 запрос на самовывоз в locB.

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    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, используя матрицу «fast».
• 1 транспортное средство начинает свой маршрут в locB и заканчивает его в locB, используя матрицу «slow».
• 1 транспортное средство начинает свой маршрут в locB и заканчивает его в locB, используя матрицу «fast».
• 1 запрос на самовывоз в locC.

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "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
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "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
    }
  }
}

string

Tags defining the sources of the duration and distance matrices; duration_distance_matrices(i).rows(j) defines durations and distances from visits with tag duration_distance_matrix_src_tags(j) to other visits in matrix i.

Tags correspond to VisitRequest.tags or Vehicle.start_tags . A given VisitRequest or Vehicle must match exactly one tag in this field. Note that a Vehicle 's source, destination and matrix tags may be the same; similarly a VisitRequest 's source and destination tags may be the same. All tags must be different and cannot be empty strings. If this field is not empty, then duration_distance_matrices must not be empty.

string

Tags defining the destinations of the duration and distance matrices; duration_distance_matrices(i).rows(j).durations(k) (resp. duration_distance_matrices(i).rows(j).meters(k)) defines the duration (resp. the distance) of the travel from visits with tag duration_distance_matrix_src_tags(j) to visits with tag duration_distance_matrix_dst_tags(k) in matrix i.

Tags correspond to VisitRequest.tags or Vehicle.start_tags . A given VisitRequest or Vehicle must match exactly one tag in this field. Note that a Vehicle 's source, destination and matrix tags may be the same; similarly a VisitRequest 's source and destination tags may be the same. All tags must be different and cannot be empty strings. If this field is not empty, then duration_distance_matrices must not be empty.

TransitionAttributes

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

ShipmentTypeIncompatibility

Наборы несовместимых shipment_types (см. ShipmentTypeIncompatibility ).

ShipmentTypeRequirement

Sets of shipment_type requirements (see ShipmentTypeRequirement ).

PrecedenceRule

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

ВАЖНО : Использование правил приоритета ограничивает размер задачи, которую можно оптимизировать. Запросы, использующие правила приоритета, которые включают множество поставок, могут быть отклонены.

int32

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

Row

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

string

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

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

All matrices must have a different vehicle_start_tag .

Duration

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

double

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

Type

The type of the objective.

double

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

bool

Indicates if the "first" event is a delivery.

bool

Indicates if the "second" event is a delivery.

Duration

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

int32

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

int32

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

int32

Vehicle performing the route, identified by its index in the source ShipmentModel .

string

Label of the vehicle performing this route, equal to ShipmentModel.vehicles(vehicle_index).label , if specified.

Timestamp

Time at which the vehicle starts its route.

Timestamp

Time at which the vehicle finishes its route.

Visit

Ordered sequence of visits representing a route. visits[i] is the i-th visit in the route. If this field is empty, the vehicle is considered as unused.

Transition

Ordered list of transitions for the route.

bool

When OptimizeToursRequest.consider_road_traffic , is set to true, this field indicates that inconsistencies in route timings are predicted using traffic-based travel duration estimates. There may be insufficient time to complete traffic-adjusted travel, delays, and breaks between visits, before the first visit, or after the last visit, while still satisfying the visit and vehicle time windows. For example,

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

Arrival at next_visit will likely happen later than its current time window due the increased estimate of travel time travel_duration(previous_visit, next_visit) due to traffic. Also, a break may be forced to overlap with a visit due to an increase in travel time estimates and visit or break time window restrictions.

EncodedPolyline

The encoded polyline representation of the route. This field is only populated if OptimizeToursRequest.populate_polylines is set to true.

Break

Breaks scheduled for the vehicle performing this route. The breaks sequence represents time intervals, each starting at the corresponding start_time and lasting duration seconds.

AggregatedMetrics

Duration, distance and load metrics for this route. The fields of AggregatedMetrics are summed over all ShipmentRoute.transitions or ShipmentRoute.visits , depending on the context.

VehicleFullness

VehicleFullness field for computing how close the capped metrics are to their respective vehicle limits. Its fields are ratios between a capped metric field (eg AggregatedMetrics.travel_distance_meters ) and the related vehicle limit (eg Vehicle.route_distance_limit ).

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

map<string, double>

Cost of the route, broken down by cost-related request fields. The keys are proto paths, relative to the input OptimizeToursRequest, eg "model.shipments.pickups.cost", and the values are the total cost generated by the corresponding cost field, aggregated over the whole route. In other words, costs["model.shipments.pickups.cost"] is the sum of all pickup costs over the route. All costs defined in the model are reported in detail here with the exception of costs related to TransitionAttributes that are only reported in an aggregated way as of 2022/01.

double

Total cost of the route. The sum of all costs in the cost map.

Timestamp

Start time of a break.

Duration

Duration of a break.

string

String representing encoded points of the polyline.

Duration

Travel duration during this transition.

double

Distance traveled during the transition.

bool

When traffic is requested via OptimizeToursRequest.consider_road_traffic , and the traffic info couldn't be retrieved for a Transition , this boolean is set to true. This may be temporary (rare hiccup in the realtime traffic servers) or permanent (no data for this location).

Duration

Sum of the delay durations applied to this transition. If any, the delay starts exactly delay_duration seconds before the next event (visit or vehicle end). See TransitionAttributes.delay .

Duration

Sum of the duration of the breaks occurring during this transition, if any. Details about each break's start time and duration are stored in ShipmentRoute.breaks .

Duration

Time spent waiting during this transition. Wait duration corresponds to idle time and does not include break time. Also note that this wait time may be split into several non-contiguous intervals.

Duration

Total duration of the transition, provided for convenience. It is equal to:

• next visit start_time (or vehicle_end_time if this is the last transition) - this transition's start_time ;
• if ShipmentRoute.has_traffic_infeasibilities is false, the following additionally holds: `total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

Start time of this transition.

EncodedPolyline

The encoded polyline representation of the route followed during the transition. This field is only populated if populate_transition_polylines is set to true.

string

Output only. An opaque token that can be passed to Navigation SDK to reconstruct the route during navigation, and, in the event of rerouting, honor the original intention when the route was created. Treat this token as an opaque blob. Don't compare its value across requests as its value may change even if the service returns the exact same route. This field is only populated if populate_transition_polylines is set to true.

map<string, VehicleLoad >

Vehicle loads during this transition, for each type that either appears in this vehicle's Vehicle.load_limits , or that have non-zero Shipment.load_demands on some shipment performed on this route.

The loads during the first transition are the starting loads of the vehicle route. Then, after each visit, the visit's load_demands are either added or subtracted to get the next transition's loads, depending on whether the visit was a pickup or a delivery.

int64

The amount of load on the vehicle, for the given type. The unit of load is usually indicated by the type. See Transition.vehicle_loads .

int32

Index of the shipments field in the source ShipmentModel .

bool

If true the visit corresponds to a pickup of a Shipment . Otherwise, it corresponds to a delivery.

int32

Index of VisitRequest in either the pickup or delivery field of the Shipment (see is_pickup ).

Timestamp

Time at which the visit starts. Note that the vehicle may arrive earlier than this at the visit location. Times are consistent with the ShipmentModel .

map<string, Load >

Total visit load demand as the sum of the shipment and the visit request load_demands . The values are negative if the visit is a delivery. Demands are reported for the same types as the Transition.loads (see this field).

Duration

Extra detour time due to the shipments visited on the route before the visit and to the potential waiting time induced by time windows. If the visit is a delivery, the detour is computed from the corresponding pickup visit and is equal to:

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

Otherwise, it is computed from the vehicle start_location and is equal to:

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

Copy of the corresponding Shipment.label , if specified in the Shipment .

string

Copy of the corresponding VisitRequest.label , if specified in the VisitRequest .

int32

An opaque token representing information about a visit location.

This field may be populated in the result routes' visits when VisitRequest.avoid_u_turns was set to true for this visit or if ShipmentModel.avoid_u_turns was set to true in the request OptimizeToursRequest .

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

string

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

IncompatibilityMode

Mode applied to the incompatibility.

string

List of alternative shipment types required by the dependent_shipment_types .

string

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

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

RequirementMode

Mode applied to the requirement.

int32

The index corresponds to the index of the shipment in the source ShipmentModel .

string

Copy of the corresponding Shipment.label , if specified in the Shipment .

Reason

A list of reasons that explain why the shipment was skipped. See comment above Reason . If we are unable to understand why a shipment was skipped, reasons will not be set.

double

This is a copy of the Shipment.penalty_cost , included here to make it easier to see the severity of a skipped shipment.

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

double

Estimated ratio of vehicles that cannot perform this shipment for at least one of the reasons below. Note: this is only filled when reasons involve a vehicle.

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

Code

Refer to the comments of Code.

int32

Same as example_vehicle_index except that we provide the list of multiple identified vehicles. This list is not necessarily exhaustive. This is only filled if [fill_example_vehicle_indices_in_skipped_reasons][] is true.

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

string

If the reason code is DEMAND_EXCEEDS_VEHICLE_CAPACITY , documents one capacity type that is exceeded.

int32

If the reason is related to a shipment-vehicle incompatibility, this field provides the index of one relevant vehicle.

Timestamp

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

Timestamp

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

Timestamp

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

Timestamp

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

double

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

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

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

double

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

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

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

string

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

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

string

See src_tag . Exactly one of src_tag and excluded_src_tag must be non-empty.

string

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

string

See dst_tag . Exactly one of dst_tag and excluded_dst_tag must be non-empty.

double

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

double

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

DistanceLimit

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

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

Duration

Specifies a delay incurred when performing this transition.

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

string

The URI of the resource. The resource may not yet exist.

The contents of the resource are encoded as either JSON or textproto. Only Google Cloud Storage resources are supported. If the resource is encoded as JSON, the resource name must be suffixed with .json . If the resource is encoded as textproto, the resource name must be suffixed with .txtpb . For example, a Google Cloud Storage URI to a JSON encoded file might look like: gs://bucket/path/input/object.json .

string

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

TravelMode

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

RouteModifiers

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

LatLng

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

Waypoint

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

LatLng

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

Waypoint

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

string

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

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

string

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

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

TimeWindow

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

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

cost_per_hour_after_soft_end_time and soft_end_time can only be set if there is a single time window.

TimeWindow

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

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

cost_per_hour_after_soft_end_time and soft_end_time can only be set if there is a single time window.

UnloadingPolicy

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

map<string, LoadLimit >

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

double

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

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

double

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

double

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

double

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

bool

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

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

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

DurationLimit

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

DurationLimit

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

DistanceLimit

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

map<string, Duration >

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

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

BreakRule

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

string

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

bool

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

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

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

double

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

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

See also extra_visit_duration_for_visit_type below.

Duration

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

Duration

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

If defined, soft_max_duration must be nonnegative. If max_duration is also defined, soft_max_duration must be less than max_duration.

Duration

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

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

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

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

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

The cost must be nonnegative.

double

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

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

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

The cost must be nonnegative.

int64

A soft limit of the load. See cost_per_unit_above_soft_max .

double

If the load ever exceeds soft_max_load along this vehicle's route, the following cost penalty applies (only once per vehicle): (load - soft_max_load ) * cost_per_unit_above_soft_max . All costs add up and must be in the same unit as Shipment.penalty_cost . Soft limits may only be defined on types that apply to either pickups only or deliveries only throughout the model.

Interval

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

Interval

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

int64

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

LoadCost

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

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

LoadCost

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

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

int64

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

int64

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

int64

Amount of load above which the cost of moving a unit of load changes from cost_per_unit_below_threshold to cost_per_unit_above_threshold. Must be >= 0.

double

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

double

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

double

Maximum of all other fields in this message.

double

The ratio between AggregatedMetrics.travel_distance_meters and Vehicle.route_distance_limit . If Vehicle.route_distance_limit is unset, this field will be unset.

double

The ratio between [AggregatedMetrics.travel_duration_seconds][] and Vehicle.travel_duration_limit . If Vehicle.travel_duration_limit is unset, this field will be unset.

double

The ratio between [AggregatedMetrics.total_duration_seconds][] and Vehicle.route_duration_limit . If Vehicle.route_duration_limit is unset, this field will be unset.

double

The maximum ratio among all types of [AggregatedMetrics.max_load][] and their respective Vehicle.load_limits . If all Vehicle.load_limits fields are unset, this field will be unset.

double

The ratio (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time) for a given vehicle. If the denominator is not present, it uses ( ShipmentModel.global_end_time - ShipmentModel.global_start_time ) instead.

bool

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

bool

Indicates that the waypoint is meant for vehicles to stop at, where the intention is to either pick up or drop off. This option works only for the 'DRIVING' travel mode, and when the 'location_type' is 'location'.

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

Location

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

string

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

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