Package google.research.middlemileoptimization.v1

Индекс

Оптимизация MiddleMile

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

КоммитПат

rpc CommitPath( CommitPathRequest ) returns ( Path )

Фиксирует путь отправления, указывая, что он не может быть изменен в будущем даже пользователем, за исключением форс-мажорных/стихийных обстоятельств, указанных методами MakeVehicleUnavailable, MakeHubUnavailable, MakeLineUnavailable. Этот метод не используется для пометки конкретной версии пути.

CreateHub

rpc CreateHub( CreateHubRequest ) returns ( Hub )

Создает хаб.

Создатьлинию

rpc CreateLine( CreateLineRequest ) returns ( Line )

Создает линию.

CreateLineRotation

rpc CreateLineRotation( CreateLineRotationRequest ) returns ( LineRotation )

Создает LineRotation.

Создать сеть

rpc CreateNetwork( CreateNetworkRequest ) returns ( Network )

Создает сеть.

Создать транспортное средство

rpc CreateVehicle( CreateVehicleRequest ) returns ( Vehicle )

Создает Транспортное средство.

УдалитьХаб

rpc DeleteHub( DeleteHubRequest ) returns ( Empty )

Удаляет хаб.

Удалитьстроку

rpc DeleteLine( DeleteLineRequest ) returns ( Empty )

Удаляет строку.

Удалитьлинейное вращение

rpc DeleteLineRotation( DeleteLineRotationRequest ) returns ( Empty )

Удаляет LineRotation.

Удалить сеть

rpc DeleteNetwork( DeleteNetworkRequest ) returns ( Empty )

Удаляет сеть.

Удалитьотгрузку

rpc DeleteShipment( DeleteShipmentRequest ) returns ( Empty )

Удаляет посылку.

Удалить транспортное средство

rpc DeleteVehicle( DeleteVehicleRequest ) returns ( Empty )

Удаляет транспортное средство.

GetHub

rpc GetHub( GetHubRequest ) returns ( Hub )

Получает сведения о концентраторе.

GetLine

rpc GetLine( GetLineRequest ) returns ( Line )

Получает сведения о строке.

GetLineRotation

rpc GetLineRotation( GetLineRotationRequest ) returns ( LineRotation )

Получает сведения о LineRotation.

GetNetwork

rpc GetNetwork( GetNetworkRequest ) returns ( Network )

Получает сведения о сети.

Получить отправку

rpc GetShipment( GetShipmentRequest ) returns ( Shipment )

Получает сведения об отправке.

Получить транспортное средство

rpc GetVehicle( GetVehicleRequest ) returns ( Vehicle )

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

ListHubs

rpc ListHubs( ListHubsRequest ) returns ( ListHubsResponse )

Перечисляет концентраторы.

ListLineRotations

rpc ListLineRotations( ListLineRotationsRequest ) returns ( ListLineRotationsResponse )

Перечисляет LineRotations.

СписокЛинии

rpc ListLines( ListLinesRequest ) returns ( ListLinesResponse )

Перечисляет линии.

Список сетей

rpc ListNetworks( ListNetworksRequest ) returns ( ListNetworksResponse )

Перечисляет сеть.

Список путей

rpc ListPaths( ListPathsRequest ) returns ( ListPathsResponse )

Возвращает все пути, доступные на данный момент. Этот метод идемпотентен и не имеет побочных эффектов.

Список поставок

rpc ListShipments( ListShipmentsRequest ) returns ( ListShipmentsResponse )

Перечисляет поставки.

СписокТранспорта

rpc ListVehicles( ListVehiclesRequest ) returns ( ListVehiclesResponse )

Перечисляет транспортные средства.

СделатьHubAvailable

rpc MakeHubAvailable( MakeHubAvailableRequest ) returns ( MakeHubAvailableResponse )

Делает хаб доступным.

MakeHubUnavailable

rpc MakeHubUnavailable( MakeHubUnavailableRequest ) returns ( MakeHubUnavailableResponse )

Делает хаб недоступным.

MakeLineAvailable

rpc MakeLineAvailable( MakeLineAvailableRequest ) returns ( MakeLineAvailableResponse )

Делает линию доступной.

MakeLineUnavailable

rpc MakeLineUnavailable( MakeLineUnavailableRequest ) returns ( MakeLineUnavailableResponse )

Делает линию недоступной.

Сделать транспортное средство доступным

rpc MakeVehicleAvailable( MakeVehicleAvailableRequest ) returns ( MakeVehicleAvailableResponse )

Делает транспортное средство доступным.

Сделать автомобиль недоступным

rpc MakeVehicleUnavailable( MakeVehicleUnavailableRequest ) returns ( MakeVehicleUnavailableResponse )

Делает автомобиль недоступным.

МаршрутОтгрузка

rpc RouteShipment( RouteShipmentRequest ) returns ( RouteShipmentResponse )

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

ОбновлениеHub

rpc UpdateHub( UpdateHubRequest ) returns ( Hub )

Обновляет хаб.

Обновление линии

rpc UpdateLine( UpdateLineRequest ) returns ( Line )

Обновляет строку.

Обновлениелиниивращения

rpc UpdateLineRotation( UpdateLineRotationRequest ) returns ( LineRotation )

Обновляет LineRotation.

Обновление сети

rpc UpdateNetwork( UpdateNetworkRequest ) returns ( Network )

Обновляет сеть.

Обновление пути

rpc UpdatePath( UpdatePathRequest ) returns ( Path )

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

Обновить транспортное средство

rpc UpdateVehicle( UpdateVehicleRequest ) returns ( Vehicle )

Обновляет транспортное средство.

Аннотатедпассегмент

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

Поля
segment

PathSegment

Необходимый. Сегмент аннотируется.

arrival_time

DateTime

Только вывод. Время прибытия этого сегмента.

departure_time

DateTime

Только вывод. Время отправления этого сегмента.

is_committed

bool

Только вывод. Решил ли клиент API зафиксировать эту часть пути.

segment_cost_constant

double

Только вывод. Постоянная стоимость для этого сегмента.

segment_cost_due_to_vehicle

map<string, double>

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

segment_cost_due_to_departure

double

Только вывод. Стоимость в связи с ротацией линий: отправление.

segment_cost_due_to_arrival

double

Только вывод. Стоимость в связи с ротацией очереди: приезд.

Запрос CommitPathRequest

Сообщение запроса для метода CommitPath .

Поля
name

string

Необходимый. Имя отправления, путь которого необходимо зафиксировать. Формат: «сети/{сеть}/отгрузки/{отгрузка}»

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

PathToCommit

Сегменты пути от источника к месту назначения.

segments

IncompletePathToCommit

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

IncompletePathToCommit

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

Поля
segments[]

PathSegment

Необходимый. Подмножество сегментов пути от источника к пункту назначения.

PathToCommit

Полный путь фиксации, от источника до пункта назначения.

Поля
segments[]

PathSegment

Необходимый. Сегменты должны быть расположены по порядку: от источника к месту назначения.

CreateHubRequest

Сообщение запроса для метода CreateHub .

Поля
parent

string

Необходимый. Родительский ресурс, в котором будет создан этот концентратор. Формат: «сети/{сеть}»

hub_id

string

Необходимый. Идентификатор создаваемого хаба.

hub

Hub

Необходимый. Хаб, который нужно создать.

CreateLineRequest

Сообщение запроса для метода CreateLine .

Поля
parent

string

Необходимый. Родительский ресурс, в котором будет создана эта строка. Формат: «сети/{сеть}»

line_id

string

Необходимый. Идентификатор создаваемой строки.

line

Line

Необходимый. Линия для создания.

CreateLineRotationRequest

Сообщение запроса для метода CreateLineRotation .

Поля
parent

string

Необходимый. Родительский ресурс, в котором будет создана эта ротация строк. Формат: «сети/{сеть}/линии/{линия}»

line_rotation_id

string

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

line_rotation

LineRotation

Необходимый. Вращение линии для создания.

Создание сетизапроса

Сообщение запроса для метода CreateNetwork .

Поля
network_id

string

Необходимый. Идентификатор создаваемой сети.

network

Network

Необходимый. Сеть, которую нужно создать.

Создать запрос транспортного средства

Сообщение запроса для метода CreateVehicle .

Поля
parent

string

Необходимый. Родительский ресурс, в котором будет создан этот автомобиль. Формат: «сети/{сеть}»

vehicle_id

string

Необходимый. Идентификатор создаваемого транспортного средства.

vehicle

Vehicle

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

Кросс-ДокингВместимость

Общая пропускная способность хаба.

Поля
capacity_per_hour[]

ValueDimension

Необязательный. Возможности кросс-докинга для каждого измерения.

Время кроссдокинга

Общее время кросс-докинга для хаба.

Поля
time_constant

Duration

Необязательный. Постоянное время для операции кросс-докинга.

time

SeparableNDFunction

Необязательный. Сепарабельность — это упрощающее предположение.

ДатаВремядиапазон

Диапазон времени между двумя DateTime. Для точечной даты и времени используйте start == end.

google/type/interval.proto служит той же цели, но с физическим временем (нас интересует только гражданское время).

Поля
first_date

DateTime

Начало диапазона.

last_date

DateTime

Конец диапазона

УдалитьHubRequest

Сообщение запроса для метода DeleteHub .

Поля
name

string

Необходимый. Имя концентратора, который требуется удалить. Формат: «сети/{сеть}/концентраторы/{концентратор}»

Удалитьлинерекуест

Сообщение запроса для метода DeleteLine .

Поля
name

string

Необходимый. Имя строки, которую нужно удалить. Формат: «сети/{сеть}/линии/{линия}»

force

bool

Необязательный. Если установлено значение true, удалите дочерние ресурсы.

Удалитьлинеротатионрекуест

Сообщение запроса для метода DeleteLineRotation .

Поля
name

string

Необходимый. Имя вращения линии, которое необходимо удалить. Формат: «сети/{сеть}/линии/{линия}/ротация/{ротация}»

Удалитьнетворкрекуест

Сообщение запроса для метода DeleteNetwork .

Поля
name

string

Необходимый. Имя сети, которую нужно удалить. Формат: «сети/{сеть}»

force

bool

Необязательный. Если установлено значение true, удалите дочерние ресурсы.

Удалитьзапрос на отправку

Сообщение запроса для метода DeleteShipment .

Поля
name

string

Необходимый. Название отправления, которое необходимо удалить. Формат: «сети/{сеть}/отгрузки/{отгрузка}»

Удалить запрос транспортного средства

Сообщение запроса для метода DeleteVehicle .

Поля
name

string

Необходимый. Название автомобиля, который нужно удалить. Формат: «сети/{сеть}/транспортные средства/{транспортное средство}»

РасстояниеМатрицаВход

Расстояние между исходным концентратором и концентратором назначения.

Поля
source_hub

string

Необходимый. Исходный центр.

destination_hub

string

Необходимый. Конечный узел.

weights[]

ValueDimension

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

Раннее опоздание

Функции затрат из-за прибытия/отправления груза раньше или позже требуемого времени (мягкие ограничения).

Поля
maximum_earliness

Duration

Необязательный. Максимально допустимая досрочность. Полезно только с затратами.

maximum_tardiness

Duration

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

earliness_cost

Function1D

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

tardiness_cost

Function1D

Необязательный. Цена опоздания. Не установлено, если нет платы за опоздание.

Функция1D

Функция одного аргумента.

Поля
function поля объединения. Единство аргумента функции предполагается: - если вес: кг - если время: мин - если количество поддонов: 1 function может быть только одной из следующих:
constant

double

Функция является константой.

pwl

PieceWiseAffineFunction

Функция кусочно-линейная.

Сгенерированнаялинияиротация

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

Поля
arrival_times

map<string, DateTime >

Только вывод. Сопоставление идентификаторов хабов и времени. Предполагается, что эта карта будет иметь те же ключи (за исключением исходного концентратора, без времени прибытия).

departure_times

map<string, DateTime >

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

GetHubRequest

Сообщение запроса для метода GetHub .

Поля
name

string

Необходимый. Имя концентратора, который требуется получить. Формат: «сети/{сеть}/концентраторы/{концентратор}»

GetLineRequest

Сообщение запроса для метода GetLine .

Поля
name

string

Необходимый. Имя сети для получения. Формат: «сети/{сеть}/линии/{линия}»

GetLineRotationRequest

Сообщение запроса для метода GetLineRotation .

Поля
name

string

Необходимый. Имя поворота строки, которое требуется получить. Формат: «сети/{сеть}/линии/{линия}/ротация/{ротация}»

GetNetworkRequest

Сообщение запроса для метода GetNetwork .

Поля
name

string

Необходимый. Имя сети для получения. Формат: «сети/{сеть}»

Получить запрос на отправку

Сообщение запроса для метода GetShipment .

Поля
name

string

Необходимый. Название груза, который требуется получить. Формат: «сети/{сеть}/отгрузки/{отгрузка}»

Получить запрос транспортного средства

Сообщение запроса для метода GetVehicle .

Поля
name

string

Необходимый. Название транспортного средства, которое требуется получить. Формат: «сети/{сеть}/транспортные средства/{транспортное средство}»

Центр

Грузы необходимо доставлять из одного узла в другой.

Поля
name

string

Необходимый. Идентификатор. Невозможно обновить.

position

LatLng

Необязательный. Позиция для вычисления реальных путей.

opening_times[]

DateTimeRange

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

cross_docking_capacity

CrossDockingCapacity

Необязательный. Емкость всего концентратора.

cross_docking_time

CrossDockingTime

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

Целочисленный диапазон

Диапазон целых чисел.

Поля
start_value

int32

Интервал открыт, если не установлен.

end_value

int32

Интервал открыт, если не установлен.

Линия

Линия, работающая на заданной частоте.

Поля
name

string

Необходимый. Идентификатор. Невозможно обновить.

hub_ids[]

string

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

ЛинияВращение

Транспортное средство начинает движение по этой линии в определенное время.

Поля
name

string

Необходимый. Идентификатор. Невозможно обновить.

arrival_times

map<string, DateTimeRange >

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

departure_times

map<string, DateTimeRange >

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

departure_earliness_tardiness_costs

map<string, EarlinessTardiness >

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

arrival_earliness_tardiness_costs

map<string, EarlinessTardiness >

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

vehicles[]

string

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

fixed_price

PricingStrategy

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

maximum_number_vehicles

IntegerRange

Необязательный. Максимальное количество транспортных средств, которые могут быть назначены на эту ротацию. Если не установлено: ограничений по количеству транспортных средств для этой ротации нет. В противном случае верхняя граница количества транспортных средств, которые могут быть выделены для этой ротации (среди разрешенного списка vehicle_ids ). В частности, значение 0 отключает это вращение (транспортные средства запрещены).

ListHubsЗапрос

Сообщение запроса для метода ListHubs .

Поля
parent

string

Необходимый. Родительский объект, которому принадлежит эта коллекция хабов. Формат: «сети/{сеть}»

page_size

int32

Необязательный. Максимальное количество возвращаемых хабов. Служба может вернуть меньшее значение, чем это значение. Если не указано, будет возвращено не более 50 концентраторов. Максимальное значение — 1000; значения выше 1000 будут приведены к 1000.

page_token

string

Необязательный. Токен страницы, полученный в результате предыдущего вызова ListHubs . Предоставьте это, чтобы получить следующую страницу.

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

ListHubsResponse

Ответное сообщение для метода ListHubs .

Поля
hubs[]

Hub

Хабы из указанной сети.

next_page_token

string

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

ListLineRotationsRequest

Сообщение запроса для метода ListLineRotations .

Поля
parent

string

Необходимый. Родитель, которому принадлежит эта коллекция поворотов строк. Формат: «сети/{сеть}/линии/{линия}»

page_size

int32

Необязательный. Максимальное количество поворотов строки для возврата. Служба может вернуть меньшее значение, чем это значение. Если не указано, будет возвращено не более 50 LineRotations. Максимальное значение — 1000; значения выше 1000 будут приведены к 1000.

page_token

string

Необязательный. Токен страницы, полученный в результате предыдущего вызова ListLineRotations . Предоставьте это, чтобы получить следующую страницу.

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

ListLineRotationsResponse

Ответное сообщение для метода ListLineRotations .

Поля
line_rotations[]

LineRotation

Вращения линий из указанной сети и линии.

next_page_token

string

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

СписокЛинийЗапрос

Сообщение запроса для метода ListLines .

Поля
parent

string

Необходимый. Родитель, которому принадлежит эта коллекция строк. Формат: «сети/{сеть}»

page_size

int32

Необязательный. Максимальное количество возвращаемых строк. Служба может вернуть меньшее значение, чем это значение. Если не указано, будет возвращено не более 50 строк. Максимальное значение — 1000; значения выше 1000 будут приведены к 1000.

page_token

string

Необязательный. Токен страницы, полученный в результате предыдущего вызова ListLines . Предоставьте это, чтобы получить следующую страницу.

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

ListLinesResponse

Ответное сообщение для метода ListLines .

Поля
lines[]

Line

Линии из указанной сети.

next_page_token

string

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

Список сетейЗапрос

Сообщение запроса для метода ListNetworks .

Поля
page_size

int32

Необязательный. Максимальное количество возвращаемых сетей. Служба может вернуть меньшее значение, чем это значение. Если не указано, будет возвращено не более 50 сетей. Максимальное значение — 1000; значения выше 1000 будут приведены к 1000.

page_token

string

Необязательный. Токен страницы, полученный в результате предыдущего вызова ListNetworks . Предоставьте это, чтобы получить следующую страницу.

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

ListNetworksResponse

Ответное сообщение для метода ListNetworks .

Поля
networks[]

Network

Список сетей.

next_page_token

string

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

ListPathsRequest

Сообщение запроса для метода ListPaths .

Поля
parent

string

Необходимый. Имя сети, для которой необходимо отправлять пути. Формат: «сети/{сеть}»

page_size

int32

Необязательный. Максимальное количество возвращаемых сетей. Служба может вернуть меньшее значение, чем это значение. Если не указано, будет возвращено не более 50 сетей. Максимальное значение — 1000; значения выше 1000 будут приведены к 1000.

page_token

string

Необязательный. Токен страницы, полученный в результате предыдущего вызова ListNetworks . Предоставьте это, чтобы получить следующую страницу.

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

ListPathsResponse

Ответное сообщение для метода ListPaths .

Поля
paths[]

Path

Список путей.

next_page_token

string

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

СписокОтгрузокЗапрос

Сообщение запроса для метода ListShipments .

Поля
parent

string

Необходимый. Родительский объект, владеющий этой коллекцией отправлений. Формат: «сети/{сеть}»

page_size

int32

Необязательный. Максимальное количество отправлений для возврата. Служба может вернуть меньшее значение, чем это значение. Если не указано, будет возвращено не более 50 отправлений. Максимальное значение — 1000; значения выше 1000 будут приведены к 1000.

page_token

string

Необязательный. Токен страницы, полученный в результате предыдущего вызова ListShipments . Предоставьте это, чтобы получить следующую страницу.

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

СписокОтправленийОтвет

Ответное сообщение для метода ListShipments .

Поля
shipments[]

Shipment

Отгрузки из указанной сети.

next_page_token

string

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

Список транспортных средствЗапрос

Сообщение запроса для метода ListVehicles .

Поля
parent

string

Необходимый. Родительская компания, владеющая этой коллекцией транспортных средств. Формат: «сети/{сеть}»

page_size

int32

Необязательный. Максимальное количество возвращаемых автомобилей. Служба может вернуть меньшее значение, чем это значение. Если не указано, будет возвращено не более 50 автомобилей. Максимальное значение — 1000; значения выше 1000 будут приведены к 1000.

page_token

string

Необязательный. Токен страницы, полученный в результате предыдущего вызова ListVehicles . Предоставьте это, чтобы получить следующую страницу.

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

ListVehiclesResponse

Ответное сообщение для метода ListVehicles .

Поля
vehicles[]

Vehicle

Автомобили из указанной сети.

next_page_token

string

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

СделатьHubAvailableRequest

Сообщение запроса для метода MakeHubAvailable .

Поля
name

string

Необходимый. Имя хаба, который нужно сделать доступным. Формат: «сети/{сеть}/концентраторы/{концентратор}»

availability_starts[]

DateTime

Необходимый. Периоды начала доступности. Это должны быть моменты времени в будущем. Если это поле отсутствует, доступность начинается с момента получения сообщения.

MakeHubAvailableResponse

Ответное сообщение для метода MakeHubAvailable .

Поля
name

string

Имя хаба, недоступность которого была обновлена. Формат: «сети/{сеть}/концентраторы/{концентратор}»

path[]

Path

Пути, которые были обновлены.

MakeHubUnavailableRequest

Сообщение запроса для метода MakeHubUnavailable .

Поля
name

string

Необходимый. Имя хаба, который нужно сделать недоступным. Формат: «сети/{сеть}/концентраторы/{концентратор}»

unavailability_starts[]

DateTime

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

MakeHubUnavailableResponse

Ответное сообщение для метода MakeHubUnavailable .

Поля
name

string

Имя хаба, недоступность которого была обновлена. Формат: «сети/{сеть}/концентраторы/{концентратор}»

path[]

Path

Пути, которые были обновлены.

MakeLineAvailableRequest

Сообщение запроса для метода MakeHubAvailable .

Поля
name

string

Необходимый. Имя линии, которую нужно сделать доступной. Формат: «сети/{сеть}/линии/{линия}»

availability_starts[]

DateTime

Необходимый. Периоды начала доступности. Это должны быть моменты времени в будущем. Если это поле отсутствует, доступность начинается с момента получения сообщения.

MakeLineAvailableResponse

Ответное сообщение для метода MakeLineAvailable .

Поля
name

string

Имя линии, недоступность которой была обновлена. Формат: «сети/{сеть}/линии/{линия}»

path[]

Path

Пути, которые были обновлены.

MakeLineUnavailableRequest

Сообщение запроса для метода MakeLineUnavailable .

Поля
name

string

Необходимый. Имя линии, которую нужно сделать недоступной. Формат: «сети/{сеть}/линии/{линия}»

unavailability_starts[]

DateTime

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

MakeLineUnavailableResponse

Ответное сообщение для метода MakeLineUnavailable .

Поля
name

string

Имя линии, недоступность которой была обновлена. Формат: «сети/{сеть}/линии/{линия}»

path[]

Path

Пути, которые были обновлены.

Сделать транспортное средство доступным запрос

Сообщение запроса для метода MakeVehicleAvailable .

Поля
name

string

Необходимый. Название транспортного средства, которое необходимо сделать доступным. Формат: «сети/{сеть}/транспортное средство/{транспортное средство}»

availability_starts[]

DateTime

Необходимый. Периоды начала доступности. Это должны быть моменты времени в будущем. Если это поле отсутствует, доступность начинается с момента получения сообщения.

MakeVehicleAvailableResponse

Ответное сообщение для метода MakeVehicleAvailable .

Поля
name

string

Название автомобиля, доступность которого была обновлена. Формат: «сети/{сеть}/транспортные средства/{транспортное средство}»

path[]

Path

Пути, которые были обновлены.

MakeVehicleUnavailableRequest

Сообщение запроса для метода MakeVehicleUnavailable .

Поля
name

string

Необходимый. Название автомобиля сделать недоступным. Формат: «сети/{сеть}/транспортные средства/{транспортное средство}»

unavailability_starts[]

DateTime

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

MakeVehicleUnavailableResponse

Ответное сообщение для метода MakeVehicleUnavailable .

Поля
name

string

Название автомобиля, недоступность которого была обновлена. Формат: «сети/{сеть}/транспортные средства/{транспортное средство}»

path[]

Path

Пути, которые были обновлены.

Сеть

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

Поля
name

string

Необходимый. Идентификатор. Невозможно обновить.

dimensions[]

ValueDimension

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

pricing

PricingStrategy

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

currency_code

string

Необязательный. Единая денежная единица, используемая во всей сети. У одного клиента API может быть несколько разных модулей для разных сетей; в сети разрешено иметь только одну денежную единицу. Единица измерения должна быть закодирована в формате ISO 4217, например google3/google/type/money.proto.

time_step

Duration

Необязательный. Дискретизация времени. Решения принимаются с такой точностью во времени. Внутри состояние сохраняется с такой точностью.

distance_matrix[]

DistanceMatrixEntry

Необязательный. Матрица расстояний (представляла список взвешенных направленных ребер).

Путь

Путь отправки внутри сети.

Поля
shipment

string

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

segments[]

AnnotatedPathSegment

Необходимый. Отрезки пути.

departure_time

DateTime

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

arrival_time

DateTime

Только вывод. Фактическое время прибытия груза.

incurred_penalties

double

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

cost_constant

double

Только вывод. Постоянная стоимость этой перевозки.

cost

map<string, double>

Только вывод. Стоимость по компонентам.

Путьсегмент

Представляет часть пути, отправленную либо клиентом API серверу API (например, изменение состояния), либо сервером API клиенту API (например, маршрутизация доставки).

Поля
source_hub

string

Необходимый. Источник сегмента.

destination_hub

string

Необходимый. Назначение сегмента.

line

string

Необходимый. Линия, соблюдаемая для этого сегмента.

line_rotation

string

Необходимый. В этом сегменте наблюдается ротация.

vehicle

string

Необходимый. Автомобиль, следующий за этим сегментом.

PieceWiseAffineФункция

Кусочно-линейная функция, ограниченная одним аргументом. Дизайн похож на https://github.com/google/or-tools/blob/stable/ortools/util/piecewise_linear_function.h.

Поля
segments[]

PieceWiseAffineSegment

Линейные отрезки функции.

PieceWiseAffineSegment

Один сегмент кусочно-линейной функции.

Поля
start_x

double

Начало сегмента: х.

start_y

double

Начало сегмента: y.

end_x

double

Конец сегмента: x.

end_y

double

Конец сегмента: y.

Стратегия ценообразования

Ценовая стратегия.

Поля
Поле объединения pricing_strategy " . Ценовая стратегия. pricing_strategy может быть только одним из следующих:
separable

SeparableNDFunction

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

МаршрутОтгрузкаЗапрос

Сообщение запроса для метода RouteShipment .

Поля
parent

string

Необходимый. Родитель, сеть, внутри которой должна быть маршрутизирована отгрузка. Формат: «сети/{сеть}»

shipment

Shipment

Необходимый. Отгрузка по маршруту.

МаршрутОтгрузкаОтвет

Ответное сообщение для метода RouteShipment .

Поля
shipment

Shipment

Отгрузка, которая была только что создана.

paths[]

Path

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

lines[]

GeneratedLineAndRotation

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

СепарабельнаяNDFunction

Функция N аргументов, выраженная как сумма функций одного аргумента.

Поля
components

map<string, Function1D >

Компоненты функции, по одной записи на каждый аргумент/измерение.

constant_price

double

Постоянная часть функции.

Отгрузка

Отгрузка для выполнения.

Поля
name

string

Необходимый. Идентификатор. Невозможно обновить.

source_hub

string

Необходимый. Центр, в котором осуществляется доставка.

destination_hub

string

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

departure_time

DateTime

Необходимый. Время отправления.

arrival_time

DateTimeRange

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

arrival_earliness_tardiness_cost

EarlinessTardiness

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

size[]

ValueDimension

Необязательный. Используется с возможностями автомобиля и концентратора.

revenue

double

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

Запрос обновленияHub

Сообщение запроса для метода UpdateHub .

Поля
hub

Hub

Необходимый. Хаб для обновления.

Поле name концентратора используется для идентификации обновляемого концентратора. Формат: «сети/{сеть}/концентраторы/{концентратор}»

update_mask

FieldMask

Необязательный. Список полей для обновления.

UpdateLineRequest

Сообщение запроса для метода UpdateLine .

Поля
line

Line

Необходимый. Строка для обновления.

Поле name строки используется для идентификации строки, которую необходимо обновить. Формат: «сети/{сеть}/линии/{линия}»

update_mask

FieldMask

Необязательный. Список полей для обновления.

UpdateLineRotationRequest

Сообщение запроса для метода UpdateLineRotation .

Поля
line_rotation

LineRotation

Необходимый. Сеть для обновления.

Поле name ротации используется для идентификации ротации, которую необходимо обновить. Формат: «сети/{сеть}/линии/{линия}/ротации/{ротация}»

update_mask

FieldMask

Необязательный. Список полей для обновления.

Обновление сетиреквест

Сообщение запроса для метода UpdateNetwork .

Поля
network

Network

Необходимый. Сеть для обновления.

Поле name сети используется для идентификации сети, которую необходимо обновить. Формат: «сети/{сеть}»

update_mask

FieldMask

Необязательный. Список полей для обновления.

Обновление путиреквеста

Сообщение запроса для метода UpdatePath .

Поля
path

Path

Необходимый. Новый путь доставки.

Запрос обновления транспортного средства

Сообщение запроса для метода UpdateVehicle .

Поля
vehicle

Vehicle

Необходимый. Автомобиль для обновления.

Поле name автомобиля используется для идентификации автомобиля, который необходимо обновить. Формат: «сети/{сеть}/транспортные средства/{транспортное средство}»

update_mask

FieldMask

Необязательный. Список полей для обновления.

ValueDimension

Значение по одному предопределенному измерению. value поля должно быть установлено в соответствии с типом dimension .

Поля
value

int64

Необязательный. Ценить.

dimension

string

Необходимый. Измерение.

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

Без имени, оно хранится как ключ карты в Сети.

Поля
name

string

Необходимый. Идентификатор. Невозможно обновить.

capacities[]

ValueDimension

Необязательный. Характеристики автомобиля.

cost

PricingStrategy

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

pricing

PricingStrategy

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

allowed_for_generated_lines

bool

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

vehicle_position_constraints[]

VehiclePositionConstraint

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

Ограничение позиции транспортного средства

Ограничение на положение автомобиля.

Поля
time

DateTime

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

hub_id

string

Центр ограничения.