Method: projects.locations.optimizeTours

string ( Duration format)

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

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

object ( ShipmentModel )

Модель доставки, которую необходимо решить.

enum ( SolvingMode )

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

enum ( SearchMode )

Для решения запроса использовался режим поиска.

object ( ShipmentRoute )

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

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

Решение должно удовлетворять ряду основных предположений о его достоверности:

• Для всех маршрутов vehicleIndex должен находиться в допустимом диапазоне и не должен дублироваться.
• Для всех посещений shipmentIndex и visitRequestIndex должны находиться в заданном диапазоне.
• Один груз может быть указан только на одном маршруте.
• Забор груза, подлежащего доставке, должен быть осуществлен до доставки.
• Допускается выполнение не более одного варианта забора или доставки груза.
• Для всех маршрутов время увеличивается (т. е. vehicleStartTime <= visits[0].start_time <= visits[1].start_time ... <= vehicleEndTime ).
• Отправка может быть осуществлена ​​только на транспортном средстве, которое разрешено. Транспортное средство разрешено, если Shipment.allowed_vehicle_indices пустое или его vehicleIndex включен в Shipment.allowed_vehicle_indices .

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

object ( InjectedSolutionConstraint )

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

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

object ( ShipmentRoute )

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

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

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

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

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

boolean

Если это правда:

• Использует ShipmentRoute.vehicle_label вместо vehicleIndex для сопоставления маршрутов во внедренном решении с транспортными средствами в запросе; повторно использует сопоставление исходного ShipmentRoute.vehicle_index с новым ShipmentRoute.vehicle_index для обновления ConstraintRelaxation.vehicle_indices , если оно не пустое, но сопоставление должно быть однозначным (т.е. несколько ShipmentRoute не должны иметь один и тот же исходный vehicleIndex ).
• Вместо shipmentIndex используется ShipmentRoute.Visit.shipment_label для сопоставления посещений во внедренном решении с отправлениями в запросе;
• Вместо SkippedShipment.index используется SkippedShipment.label для сопоставления пропущенных отправок во внедренном решении с запрошенными отправками.

Данная интерпретация применяется к полям injectedFirstSolutionRoutes , injectedSolutionConstraint и refreshDetailsRoutes . Она может использоваться, если индексы отгрузок или транспортных средств в запросе изменились с момента создания решения, например, из-за удаления или добавления отгрузок или транспортных средств в запрос.

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

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

Если vehicleLabel во внедренном решении не соответствует запрошенному транспортному средству, соответствующий маршрут удаляется из решения вместе с его посещениями. Если shipmentLabel во внедренном решении не соответствует запрошенной отправке, соответствующее посещение удаляется из решения. Если SkippedShipment.label во внедренном решении не соответствует запрошенной отправке, SkippedShipment удаляется из решения.

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

ПРИМЕЧАНИЕ: Вызывающая сторона должна убедиться, что каждый Vehicle.label (соответственно, Shipment.label ) однозначно идентифицирует сущность транспортного средства (соответственно, груза), используемую в двух соответствующих запросах: в предыдущем запросе, который сформировал OptimizeToursResponse используемый во внедренном решении, и в текущем запросе, который включает внедренное решение. Описанных выше проверок на уникальность недостаточно для обеспечения выполнения этого требования.

boolean

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

boolean

Если это так, полилинии будут заполнены в ответ на запрос ShipmentRoute .

boolean

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

boolean

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

boolean

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

string

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

number

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

integer

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