Package maps.fleetengine.delivery.v1

DeliveryRequestHeader

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

string

Необходимый. Родительский ресурс, общий для всех задач. Это значение должно быть в формате providers/{provider} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project . Родительское поле в сообщениях CreateTaskRequest должно быть либо пустым, либо соответствовать этому полю.

CreateTaskRequest

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

Task

Созданные Задачи.

DeliveryRequestHeader

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

string

Необходимый. Должно быть в формате providers/{provider} . Поставщиком должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project .

string

Необходимый. Идентификатор средства доставки должен быть уникальным и подчиняться следующим ограничениям:

• Должна быть допустимой строкой Unicode.
• Ограничено максимальной длиной в 64 символа.
• Нормализовано в соответствии с формой нормализации Unicode C.
• Не может содержать следующие символы ASCII: «/», «:», «?», «,» или «#».

DeliveryVehicle

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

• последнее_местоположение
• атрибуты

Примечание. Поле name DeliveryVehicle игнорируется. Все остальные поля DeliveryVehicle не должны быть заданы; в противном случае возвращается ошибка.

DeliveryRequestHeader

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

string

Необходимый. Должно быть в формате providers/{provider} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project .

string

Необходимый. Идентификатор задачи должен быть уникальным, но не должен быть идентификатором отслеживания отправления. Чтобы сохранить идентификатор отслеживания отправления, используйте поле tracking_id . Обратите внимание, что несколько задач могут иметь один и тот же tracking_id . На идентификаторы задач распространяются следующие ограничения:

• Должна быть допустимой строкой Unicode.
• Ограничено максимальной длиной в 64 символа.
• Нормализовано в соответствии с формой нормализации Unicode C.
• Не может содержать следующие символы ASCII: «/», «:», «?», «,» или «#».

Task

Необходимый. Сущность Task, которую необходимо создать. При создании Задачи обязательны следующие поля:

• type
• state (должно быть установлено на OPEN )
• tracking_id (не должен быть установлен для задач UNAVAILABLE или SCHEDULED_STOP , но необходим для всех остальных типов задач)
• planned_location (необязательно для UNAVAILABLE задач)
• task_duration

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

string

Код языка BCP-47, например en-US или sr-Latn. Для получения дополнительной информации см. http://www.unicode.org/reports/tr35/#Unicode_locale_identifier . Если ничего не указано, ответ может быть на любом языке, предпочтительно на английском языке, если такое имя существует. Пример значения поля: en-US .

string

Необходимый. CLDR-код региона, откуда исходит запрос. Пример значения поля: US .

string

Версия вызывающего SDK, если применимо. Формат версии — «major.minor.patch», пример: 1.1.2 .

string

Версия операционной системы, в которой работает вызывающий SDK. Примеры значений полей: 4.4.1 , 12.1 .

string

Модель устройства, на котором запущен вызывающий SDK. Примеры значений полей: iPhone12,1 , SM-G920F .

SdkType

Тип SDK, отправляющего запрос.

string

Версия MapSDK, от которой зависит вызывающий SDK, если применимо. Формат версии — «major.minor.patch», пример: 5.2.1 .

string

Версия NavSDK, от которой зависит вызывающий SDK, если применимо. Формат версии — «major.minor.patch», пример: 2.1.0 .

Platform

Платформа вызывающего SDK.

string

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

int32

Уровень Android API вызывающего SDK, применим только для Android SDK. Пример значения поля: 23 .

string

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

string

Уникальное имя этого средства доставки. Формат: providers/{provider}/deliveryVehicles/{vehicle} .

DeliveryVehicleLocation

Последнее сообщенное местоположение Транспортного средства доставки.

DeliveryVehicleNavigationStatus

Навигационный статус транспортного средства доставки.

bytes

Закодированная ломаная линия, определяющая маршрут, по которому система навигации рекомендует следовать до следующей путевой точки. Ваше приложение для водителя обновляет это, когда остановка достигнута или пройдена, а также когда навигация меняет маршрут. Эти LatLng возвращаются в Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) или Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) ​​для всех активных задач, назначенных Транспортному средству.

В некоторых случаях это поле может не использоваться для заполнения Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) или Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):

• Конечная точка current_route_segment не соответствует DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) или DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST).

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

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

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

LatLng

Место, где заканчивается current_route_segment . В настоящее время оно не заполняется приложением драйвера, но вы можете предоставить его при вызовах UpdateDeliveryVehicle . Это либо LatLng от предстоящей остановки транспортного средства, либо последняя LatLng из current_route_segment . Затем Fleet Engine сделает все возможное, чтобы интерполировать фактический VehicleStop .

Это поле игнорируется при вызовах UpdateDeliveryVehicle , если поле current_route_segment пусто.

Int32Value

Оставшееся расстояние поездки для current_route_segment . Приложение Driver обычно предоставляет это поле, но в некоторых случаях Fleet Engine переопределяет значение, отправленное приложением. Дополнительные сведения см. в разделе DeliveryVehicle.current_route_segment . Это поле возвращается в Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) или Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) ​​для всех активных Task , назначенных средству доставки.

Fleet Engine игнорирует это поле в UpdateDeliveryVehicleRequest , если поле current_route_segment пусто.

Duration

Оставшееся время в пути для current_route_segment . Приложение Driver обычно предоставляет это поле, но в некоторых случаях Fleet Engine переопределяет значение, отправленное приложением. Дополнительные сведения см. в разделе DeliveryVehicle.current_route_segment . Это поле возвращается в Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) или Task.remainingVehicleJourneySegments[0].drivingDuration (REST) ​​для всех активных задач, назначенных средству доставки.

Fleet Engine игнорирует это поле в UpdateDeliveryVehicleRequest , если поле current_route_segment пусто.

VehicleJourneySegment

Сегменты поездки, назначенные этому Транспортному средству доставки, начиная с последнего указанного местоположения Транспортного средства. Это поле не будет заполнено в ответе ListDeliveryVehicles .

DeliveryVehicleAttribute

Список пользовательских атрибутов средства доставки. Средство доставки может иметь не более 100 атрибутов, и каждый атрибут должен иметь уникальный ключ.

DeliveryVehicleType

Тип этого средства доставки. Если этот параметр не установлен, по умолчанию будет установлено значение AUTO .

string

Ключ атрибута.

string

Значение атрибута.

string

Значение атрибута строкового типа.

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

bool

Значение атрибута логического типа.

double

Значение атрибута с двойным типом.

LatLng

Местоположение транспортного средства. Когда данные отправляются в Fleet Engine, местоположение транспортного средства определяется по GPS. Когда вы получите его в ответе, местоположение автомобиля может быть либо местоположением GPS, дополнительным местоположением, либо каким-либо другим предполагаемым местоположением. Источник указан в location_sensor .

DoubleValue

Устарело: вместо этого используйте latlng_accuracy .

DoubleValue

Точность location в метрах как радиус.

Int32Value

Направление движения автомобиля в градусах. 0 представляет север. Допустимый диапазон: [0,360).

DoubleValue

Устарело: вместо этого используйте heading_accuracy .

DoubleValue

Точность heading в градусах.

DoubleValue

Высота в метрах над WGS84.

DoubleValue

Устарело: вместо этого используйте altitude_accuracy .

DoubleValue

Точность altitude в метрах.

Int32Value

Скорость автомобиля в километрах в час. Устарело: вместо этого используйте speed .

DoubleValue

Скорость автомобиля в метрах/секунду

DoubleValue

Точность speed в метрах/секунду.

Timestamp

Время, когда датчик сообщил о location по часам датчика.

Timestamp

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

DeliveryVehicleLocationSensor

Поставщик данных о местоположении (например, GPS ).

BoolValue

Привязано ли location к дороге.

BoolValue

Только ввод. Указывает, включен ли датчик GPS на мобильном устройстве.

Int32Value

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

Int32Value

Только ввод. Устарело: теперь для определения устаревшего местоположения используются другие сигналы.

LatLng

Необработанное местоположение автомобиля (не обработанное дорожным снаппером).

Timestamp

Временная метка, связанная с необработанным местоположением.

DeliveryVehicleLocationSensor

Источник исходного местоположения. По умолчанию GPS .

DoubleValue

Точность raw_location как радиуса в метрах.

LatLng

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

Timestamp

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

DeliveryVehicleLocationSensor

Источник дополнительной локации. По умолчанию CUSTOMER_SUPPLIED_LOCATION .

DoubleValue

Точность supplemental_location по радиусу в метрах.

bool

Устарело: вместо этого используйте is_road_snapped .

DeliveryRequestHeader

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

string

Необходимый. Должно быть в формате providers/{provider}/deliveryVehicles/{delivery_vehicle} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project .

DeliveryRequestHeader

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

string

Необходимый. Должно быть в формате providers/{provider}/tasks/{task} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project .

DeliveryRequestHeader

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

string

Необходимый. Должно быть в формате providers/{provider}/taskTrackingInfo/{tracking_id} . provider должен быть идентификатор проекта Google Cloud, а tracking_id — идентификатор отслеживания, связанный с задачей. Примером имени может быть providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id .

DeliveryRequestHeader

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

string

Необходимый. Должно быть в формате providers/{provider} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project .

int32

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

string

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

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

string

Необязательный. Запрос-фильтр, применяемый при перечислении средств доставки. См. http://aip.dev/160 для примеров синтаксиса фильтра. Если вы не укажете значение или укажете пустую строку для фильтра, будут возвращены все средства доставки.

Обратите внимание, что для ListDeliveryVehicles поддерживаются только запросы по атрибутам транспортных средств (например, attributes.<key> = <value> или attributes.<key1> = <value1> AND attributes.<key2> = <value2> ). Кроме того, все атрибуты хранятся в виде строк, поэтому единственным поддерживаемым сравнением атрибутов является сравнение строк. Для сравнения с числовыми или логическими значениями значения должны быть явно заключены в кавычки, чтобы их можно было рассматривать как строки (например, attributes.<key> = "10" или attributes.<key> = "true" ).

Максимальное количество ограничений, разрешенных в запросе фильтра, — 50. Ограничение — это часть запроса attribute.<KEY> <COMPARATOR> <VALUE> , например attributes.foo = bar — 1 ограничение.

Viewport

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

DeliveryVehicle

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

string

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

int64

Общее количество средств доставки, соответствующих критериям запроса, на всех страницах.

DeliveryRequestHeader

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

string

Необходимый. Должно быть в формате providers/{provider} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project .

int32

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

string

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

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

string

Необязательный. Запрос фильтра, который будет применяться при перечислении задач. См. http://aip.dev/160 для примеров синтаксиса фильтров. Если вы не укажете значение или отфильтруете пустую строку, будут возвращены все задачи. Информацию о свойствах задачи, по которым можно фильтровать, см. в списке задач .

Task

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

string

Передайте этот токен в ListTasksRequest , чтобы продолжить выводить результаты. Если все результаты возвращены, то это поле либо пустая строка, либо оно не отображается в ответе.

int64

Общее количество задач, соответствующих критериям запроса, на всех страницах.

LatLng

Координаты локации.

DeliveryRequestHeader

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

string

Необходимый. Должно быть в формате providers/{provider} . Поставщиком должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project .

string

Необходимый. Идентификатор набора запрашиваемых связанных задач. На идентификаторы отслеживания распространяются следующие ограничения:

• Должна быть допустимой строкой Unicode.
• Ограничена максимальной длиной в 64 символа.
• Нормализовано в соответствии с формой нормализации Unicode C.
• Не может содержать следующие символы ASCII: «/», «:», «?», «,» или «#».

int32

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

string

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

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

Task

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

string

Передайте этот токен в SearchTasksRequest , чтобы продолжить выводить результаты. Если все результаты возвращены, то это поле либо пустая строка, либо оно не отображается в ответе.

string

Должно быть в формате providers/{provider}/tasks/{task} .

Type

Необходимый. Неизменный. Определяет тип Задачи. Например, перерыв или пересылка.

State

Необходимый. Текущее состояние выполнения Задачи.

TaskOutcome

Результат выполнения задачи.

Timestamp

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

LocationInfo

Место, где был установлен результат Task . Это значение обновляется как часть UpdateTask . Если поставщик не обновил это значение явно, то Fleet Engine по умолчанию заполняет его последним известным местоположением транспортного средства ( необработанным местоположением).

TaskOutcomeLocationSource

Указывает, откуда взялось значение task_outcome_location .

string

Неизменный. Это поле облегчает хранение идентификатора, поэтому вы можете избежать использования сложного сопоставления. Вы не можете установить tracking_id для задач типа UNAVAILABLE и SCHEDULED_STOP . На эти идентификаторы распространяются следующие ограничения:

• Должна быть допустимой строкой Unicode.
• Ограничена максимальной длиной в 64 символа.
• Нормализовано в соответствии с формой нормализации Unicode C.
• Не может содержать следующие символы ASCII: «/», «:», «?», «,» или «#».

string

Только вывод. Идентификатор транспортного средства, выполняющего эту задачу. На идентификаторы транспортных средств доставки распространяются следующие ограничения:

• Должна быть допустимой строкой Unicode.
• Ограничена максимальной длиной в 64 символа.
• Нормализовано в соответствии с формой нормализации Unicode C.
• Не может содержать следующие символы ASCII: «/», «:», «?», «,» или «#».

LocationInfo

Неизменный. Место, где будет выполнено задание. Необязательно для UNAVAILABLE задач, но необходимо для всех остальных задач.

Duration

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

TimeWindow

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

JourneySharingInfo

Только вывод. Поля, специфичные для совместного использования путешествий. Не заполняется, когда состояние CLOSED .

TaskTrackingViewConfig

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

TaskAttribute

Список пользовательских атрибутов задачи. Каждый атрибут должен иметь уникальный ключ.

VehicleJourneySegment

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

Первый сегмент, Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) или Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST), содержит информацию о маршруте от последнего известного местоположения водителя до предстоящей VehicleStop . Информация о текущем маршруте обычно поступает из приложения водителя, за исключением некоторых случаев, отмеченных в документации для DeliveryVehicle.current_route_segment . Остальные сегменты в Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) или Task.journeySharingInfo.remainingVehicleJourneySegments (REST) ​​заполняются Fleet Engine. Они предоставляют информацию о маршруте между оставшимися VehicleStops .

DeliveryVehicleLocation

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

bool

Указывает, можно ли привязать LastLocation транспортного средства к current_route_segment . Это значение имеет значение False, если last_location или current_route_segment не существуют. Это значение рассчитывается Fleet Engine. Обновления от клиентов игнорируются.

string

Ключ атрибута. Ключи не могут содержать символ двоеточия (:).

string

Значение атрибута строкового типа.

bool

Значение атрибута логического типа.

double

Значение атрибута с двойным типом.

string

Должно быть в формате providers/{provider}/taskTrackingInfo/{tracking} , где tracking представляет собой идентификатор отслеживания.

string

Неизменный. Идентификатор отслеживания задачи. * Должна быть допустимой строкой Юникода. * Максимальная длина ограничена 64 символами. * Нормализовано в соответствии с формой нормализации Unicode C. * Не может содержать следующие символы ASCII: «/», «:», «?», «,» или «#».

DeliveryVehicleLocation

Последнее местоположение автомобиля.

LatLng

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

Int32Value

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

Int32Value

Общее оставшееся расстояние в метрах до интересующей VehicleStop .

Timestamp

Временная метка, указывающая расчетное время прибытия к месту остановки.

Timestamp

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

State

Текущее состояние выполнения Задачи.

TaskOutcome

Результат попытки выполнить Задачу.

Timestamp

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

LocationInfo

Неизменный. Место, где будет выполнено задание.

TimeWindow

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

TaskAttribute

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

VisibilityOption

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

VisibilityOption

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

VisibilityOption

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

VisibilityOption

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

VisibilityOption

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

VisibilityOption

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

int32

Этот элемент данных виден конечным пользователям, если оставшееся количество остановок <= rest_stop_count_threshold.

Duration

Этот элемент данных виден конечным пользователям, если расчетное время прибытия до остановки <= period_until_estimated_arrival_time_threshold.

int32

Этот элемент данных виден конечным пользователям, если оставшееся расстояние поездки в метрах <= rest_driving_distance_meters_threshold.

bool

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

bool

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

Timestamp

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

Timestamp

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

DeliveryRequestHeader

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

DeliveryVehicle

Необходимый. ОБНОВЛЕНИЕ ПРЕИМУЩЕСТВО DeliveryVehicle ПРИМЕНЕНИЯ. Примечание. Вы не можете обновить имя DeliveryVehicle .

FieldMask

Необходимый. Полевая маска, которая указывает, какие поля DeliveryVehicle для обновления. Обратите внимание, что Update_mask должен содержать хотя бы одно поле.

Это разделенный запятой список полностью квалифицированных имен полей. Пример: "remaining_vehicle_journey_segments"

DeliveryRequestHeader

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

Task

Необходимый. Задача, связанная с обновлением. Следующие поля поддерживаются флотом двигателем. Не обновляйте их, используя Task.update .

• last_location .
• last_location_snappable .
• name .
• remaining_vehicle_journey_segments
• task_outcome_location_source .

Примечание. Вы не можете изменить значение task_outcome , как только вы его установите.

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

FieldMask

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

Это разделенный запятой список полностью квалифицированных имен полей. Пример: "task_outcome,task_outcome_time,task_outcome_location" .

VehicleStop

Указывает место остановки, а также Task , связанные с остановкой. Некоторые поля автомобиля может не присутствовать, если этот сегмент путешествия является частью JourneySharingInfo .

Int32Value

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

Duration

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

Если это поле определено в The Path Task.remaining_vehicle_journey_segments[0].driving_duration Task.remainingVehicleJourneySegments[0].drivingDuration DeliveryVehicle.remaining_duration ) или DeliveryVehicle.remainingDuration (отдых). Это обеспечивает оставшуюся продолжительность вождения от последнего известного местоположения приложения Драйвера, а не время вождения с предыдущей остановки.

LatLng

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

Если это поле определено в The Path Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path LatLng grpc DeliveryVehicle.current_route_segment или Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (grpc) или DeliveryVehicle.currentRouteSegment (REST). Это обеспечивает путь въезда от последнего известного местоположения приложения Драйвера, а не пути от предыдущей остановки.

LocationInfo

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

TaskInfo

Список Task , которые будут выполнены на этой остановке. Это поле не будет заполнено в ответ на вызов GetTask или SearchTasks .

State

Состояние VehicleStop . Это поле не будет заполнено в ответ ни на GetTask , ни на вызов SearchTasks .

string

Идентификатор задачи. Это поле не будет заполнено в ответ ни на GetTask , ни на вызов SearchTasks . Идентификаторы задачи подлежат следующим ограничениям:

• Должен быть допустимая строка Unicode.
• Ограничен максимальной длиной 64 символов.
• Нормализовано в соответствии с формой нормализации Unicode c .
• Не может содержать ни одного из следующих символов ASCII: '/', ':', '?', ',' Или '#'.

Duration

Только вывод. Время, необходимое для выполнения задачи.

TimeWindow

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