Package maps.fleetengine.v1

BatteryStatus

Состояние аккумулятора: полный или заряжающийся и т. д.

PowerSource

Состояние источника питания аккумулятора.

float

Текущий процент заряда батареи [0-100].

SpeedReadingInterval

Скорость движения на пути от предыдущей путевой точки до текущей.

string

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

RequestHeader

Стандартный заголовок запроса Fleet Engine.

string

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

string

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

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

Trip

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

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

• trip_type
• pickup_point

Следующие поля используются, если вы их предоставите:

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

Все остальные поля «Поездка» игнорируются. Например, все поездки начинаются со trip_status , равного NEW даже если вы передадите trip_status , равный CANCELED в запросе на создание.

Только EXCLUSIVE поездки поддерживают intermediate_destinations .

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

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

Поля trip_id , waypoint_type и location используются, а все остальные поля TripWaypoint в vehicle_waypoints игнорируются.

RequestHeader

Стандартный заголовок запроса Fleet Engine.

string

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

string

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

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

Vehicle

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

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

При создании ТС игнорируются следующие поля:

• name
• currentTrips
• availableCapacity
• current_route_segment
• current_route_segment_end_point
• current_route_segment_version
• current_route_segment_traffic
• route
• waypoints
• waypoints_version
• remaining_distance_meters
• remaining_time_seconds
• eta_to_next_waypoint
• navigation_status

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

LocationPowerSaveMode

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

bool

Находится ли устройство в режиме энергосбережения.

bool

Находится ли устройство в интерактивном состоянии.

BatteryInfo

Информация о состоянии батареи.

RequestHeader

Стандартный заголовок запроса Fleet Engine.

string

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

TripView

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

Timestamp

Указывает минимальную временную метку (эксклюзивную), для которой извлекаются данные Trip.route или Trip.current_route_segment . Если данные маршрута не изменились с момента этой временной метки, поле маршрута не задается в ответе. Если минимум не указан, данные маршрута извлекаются всегда.

Timestamp

Указывает минимальную временную метку (эксклюзивную), для которой извлекаются Trip.remaining_waypoints . Если они не изменились с момента этой временной метки, remaining_waypoints не задаются в ответе. Если это поле не указано, remaining_waypoints всегда извлекаются.

PolylineFormatType

Возвращаемый формат текущего маршрута: LAT_LNG_LIST_TYPE (в Trip.route ) или ENCODED_POLYLINE_TYPE (в Trip.current_route_segment ). По умолчанию используется LAT_LNG_LIST_TYPE .

Timestamp

Указывает минимальную временную метку (эксклюзивную), для которой извлекается Trip.current_route_segment_traffic . Если данные о трафике не изменились с момента этой временной метки, поле current_route_segment_traffic не устанавливается в ответе. Если минимум не указан, данные о трафике извлекаются всегда. Обратите внимание, что трафик доступен только для клиентов On-Demand Rides and Delivery Solution.

Timestamp

Указывает минимальную временную метку (эксклюзивную), для которой извлекаются данные Trip.remaining_waypoints.traffic_to_waypoint и Trip.remaining_waypoints.path_to_waypoint . Если данные не изменились с момента этой временной метки, приведенные выше поля не задаются в ответе. Если remaining_waypoints_route_version не указан, трафик и путь всегда извлекаются.

RequestHeader

Стандартный заголовок запроса Fleet Engine.

string

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

Timestamp

Указывает минимальную временную метку (эксклюзивную), для которой извлекается Vehicle.current_route_segment . Если маршрут не изменился с момента этой временной метки, поле current_route_segment не устанавливается в ответе. Если минимум не указан, всегда извлекается current_route_segment .

Timestamp

Указывает минимальную временную метку (эксклюзивную), для которой извлекаются данные Vehicle.waypoints . Если путевые точки не изменились с момента этой временной метки, данные vehicle.waypoints не задаются в ответе. Если это поле не указано, vehicle.waypoints извлекается всегда.

string

Необходимый. Код страны/региона CLDR. Например, US для США или IN для Индии.

string

Последняя цифра номерного знака или «-1», обозначающая отсутствие числового значения, присутствует в номерном знаке.

• «АВС 1234» -> «4»
• «АБ 123 CD» -> «3»
• «ABCDEF» -> «-1»

RequestHeader

Стандартный заголовок запроса Fleet Engine.

string

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

int32

Максимальное количество возвращаемых автомобилей. Значение по умолчанию: 100.

string

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

Int32Value

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

TripType

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

Duration

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

Category

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

string

Вызывающие программы могут формировать сложные логические операции, используя любую комбинацию полей required_attributes , required_one_of_attributes и required_one_of_attribute_sets .

required_attributes — это список; required_one_of_attributes использует сообщение, которое разрешает список списков. В сочетании эти два поля позволяют составить это выражение:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Ограничивает ответ транспортными средствами с указанными атрибутами. Это поле представляет собой операцию конъюнкции/И. Разрешается максимум 50 обязательных_атрибутов. Это соответствует максимальному количеству атрибутов, разрешенных для транспортного средства. Каждая повторяющаяся строка должна иметь формат «ключ:значение».

string

Ограничивает ответ транспортными средствами, имеющими хотя бы один из указанных атрибутов в каждом VehicleAttributeList . В каждом списке транспортное средство должно соответствовать хотя бы одному из атрибутов. Это поле представляет собой включающую операцию разъединения/ИЛИ в каждом VehicleAttributeList и операцию объединения/И в коллекции VehicleAttributeList . Каждая повторяющаяся строка должна иметь формат «ключ1:значение1|ключ2:значение2|ключ3:значение3».

string

required_one_of_attribute_sets предоставляет дополнительную функциональность.

Подобно required_one_of_attributes , required_one_of_attribute_sets использует сообщение, которое разрешает список списков, допуская такие выражения, как это:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Ограничивает ответ транспортными средствами, которые соответствуют всем атрибутам в VehicleAttributeList . В каждом списке транспортное средство должно соответствовать всем атрибутам. Это поле представляет собой операцию соединения/И в каждом VehicleAttributeList и инклюзивную операцию разъединения/ИЛИ в коллекции VehicleAttributeList . Каждая повторяющаяся строка должна иметь формат «ключ1:значение1|ключ2:значение2|ключ3:значение3».

VehicleState

Ограничивает ответ транспортными средствами, имеющими это состояние.

bool

Возвращайте только автомобили с текущей поездкой(ями).

string

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

Это поле предназначено для замены полей required_attributes , required_one_of_attributes и required_one_of_attributes_sets ». Если здесь указано непустое значение, следующие поля должны быть пустыми: required_attributes , required_one_of_attributes и required_one_of_attributes_sets .

Этот фильтр работает как предложение AND с другими ограничениями, такими как vehicle_state или on_trip_only .

Обратите внимание, что поддерживаются только запросы по атрибутам транспортного средства (например, attributes.<key> = <value> или attributes.<key1> = <value1> AND attributes.<key2> = <value2> ). Максимальное количество ограничений, разрешенное в запросе фильтра, — 50.

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

Viewport

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

Vehicle

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

string

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

int64

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

string

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

string

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

BillingPlatformIdentifier

Платформа, на которой был отправлен запрос.

string

Идентификаторы, которые напрямую связаны с сообщаемой поездкой. Обычно это идентификаторы (например, идентификаторы сеансов) операций предварительного бронирования, выполненных до того, как идентификатор поездки станет доступен. Количество related_ids ограничено 50.

SolutionType

Тип решения по продукту GMP (например, ON_DEMAND_RIDESHARING_AND_DELIVERIES ), использованного для указанной поездки.

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

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

RequestHeader

Стандартный заголовок запроса Fleet Engine.

string

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

string

Транспортное средство, связанное с поездками в запросе. Если не указано, возвращенные поездки не содержат:

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

Если установлено значение true, ответ включает поездки, влияющие на маршрут водителя.

int32

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

string

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

Duration

Если указано, возвращает поездки, которые не были обновлены по истечении времени (current - minimum_staleness) .

Trip

Список поездок для запрошенного автомобиля.

string

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

RequestHeader

Стандартный заголовок запроса Fleet Engine.

string

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

TerminalLocation

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

TerminalLocation

Предполагаемое место высадки клиента. Поле является обязательным, если trip_types содержит TripType.SHARED .

int32

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

int32

Необходимый. Указывает максимальное количество возвращаемых транспортных средств. Значение должно находиться в диапазоне от 1 до 50 (включительно).

int32

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

TripType

Необходимый. Представляет тип предлагаемой поездки. Должен включать ровно один тип. UNKNOWN_TRIP_TYPE не разрешен. Ограничивает поиск только теми транспортными средствами, которые поддерживают данный тип поездки.

Duration

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

VehicleType

Необходимый. Ограничивает поиск транспортными средствами одного из указанных типов. Должен быть указан хотя бы один тип транспортного средства. Типы транспортных средств с категорией UNKNOWN не допускаются.

VehicleAttribute

Вызывающие программы могут формировать сложные логические операции, используя любую комбинацию полей required_attributes , required_one_of_attributes и required_one_of_attribute_sets .

required_attributes — это список; required_one_of_attributes использует сообщение, которое разрешает список списков. В сочетании эти два поля позволяют составить это выражение:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Ограничивает поиск только теми транспортными средствами с указанными атрибутами. Это поле представляет собой операцию конъюнкции/И. Разрешается максимум 50 обязательных_атрибутов. Это соответствует максимальному количеству атрибутов, разрешенных для транспортного средства.

VehicleAttributeList

Ограничивает поиск только теми транспортными средствами, у которых есть хотя бы один из указанных атрибутов в каждом VehicleAttributeList . В каждом списке транспортное средство должно соответствовать хотя бы одному из атрибутов. Это поле представляет собой включающую операцию разъединения/ИЛИ в каждом VehicleAttributeList и операцию объединения/И в коллекции VehicleAttributeList .

VehicleAttributeList

required_one_of_attribute_sets предоставляет дополнительную функциональность.

Подобно required_one_of_attributes , required_one_of_attribute_sets использует сообщение, которое разрешает список списков, допуская такие выражения, как это:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Ограничивает поиск только теми транспортными средствами, которые имеют все атрибуты в VehicleAttributeList . В каждом списке транспортное средство должно соответствовать всем атрибутам. Это поле представляет собой операцию соединения/И в каждом VehicleAttributeList и инклюзивную операцию разъединения/ИЛИ в коллекции VehicleAttributeList .

VehicleMatchOrder

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

bool

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

Значение по умолчанию — false .

string

Указывает поездку, связанную с этим SearchVehicleRequest .

CurrentTripsPresent

Это указывает на то, подходят ли для этого поиска автомобили с активными поездками. Должно быть установлено значение, отличное от CURRENT_TRIPS_PRESENT_UNSPECIFIED если trip_type включает SHARED .

string

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

Это поле предназначено для замены полей required_attributes , required_one_of_attributes и required_one_of_attributes_sets ». Если здесь указано непустое значение, следующие поля должны быть пустыми: required_attributes , required_one_of_attributes и required_one_of_attributes_sets .

Этот фильтр работает как предложение AND с другими ограничениями, такими как minimum_capacity или vehicle_types .

Обратите внимание, что поддерживаются только запросы по атрибутам транспортного средства (например, attributes.<key> = <value> или attributes.<key1> = <value1> AND attributes.<key2> = <value2> ). Максимальное количество ограничений, разрешенное в запросе фильтра, — 50.

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

VehicleMatch

Список транспортных средств, соответствующих критериям SearchVehiclesRequest , упорядоченных по полю SearchVehiclesRequest.order_by .

int32

Начальный индекс этого интервала в пути. В JSON, когда индекс равен 0, поле будет незаполненным.

int32

Конечный индекс этого интервала в пути. В JSON, когда индекс равен 0, поле будет незаполненным.

Speed

Скорость движения в этом интервале.

LatLng

Необходимый. Обозначает фактическое местоположение.

Timestamp

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

Timestamp

Только ввод. Устарело. Используйте поле отметки времени.

LatLng

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

TerminalPointId

Устарело: вместо этого укажите поле point .

string

Устарело: вместо этого укажите поле point .

string

Устарело.

WaypointType

Устарело: эти данные будут содержаться Vehicle.waypoint .

string

Устарело.

string

Устарело.

string

Устарело.

VisualTrafficReportPolylineRendering

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

string

Только вывод. В формате "провайдеры/{провайдер}/поездки/{поездка}"

string

Идентификатор транспортного средства, совершающего эту поездку.

TripStatus

Текущий статус поездки.

TripType

Тип поездки.

TerminalLocation

Место, где клиент укажет, что его заберут.

StopLocation

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

StopLocation

Только ввод. Фактическое время и место прибытия водителя в пункт выдачи. Это поле предназначено для предоставления поставщиком информации о фактическом прибытии в пункт выдачи.

Timestamp

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

TerminalLocation

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

Timestamp

Указывает, когда в последний раз было изменено intermediate_destinations . Ваш сервер должен кэшировать это значение и передавать его в UpdateTripRequest при обновлении intermediate_destination_index , чтобы гарантировать, что intermediate_destinations не изменены.

int32

Когда TripStatus равен ENROUTE_TO_INTERMEDIATE_DESTINATION , число между [0..N-1], указывающее, какой промежуточный пункт назначения транспортное средство пересечет следующим. Когда TripStatus имеет ARRIVED_AT_INTERMEDIATE_DESTINATION , число между [0..N-1], указывающее, в каком промежуточном пункте назначения находится транспортное средство. Это значение устанавливает провайдер. Если intermediate_destinations нет, это поле игнорируется.

StopLocation

Только ввод. Фактическое время и место прибытия водителя в промежуточный пункт назначения. Это поле предназначено для предоставления поставщиком информации о фактическом прибытии в промежуточные пункты назначения.

StopLocation

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

TerminalLocation

Место, где клиент указывает, что его высадят.

StopLocation

Только ввод. Фактическое время и место, когда и где высадили клиента. Это поле предназначено для предоставления поставщиком обратной связи по фактической информации о возврате.

Timestamp

Только вывод. Либо предполагаемое будущее время, когда пассажир(ы) будут высажены в конечном пункте назначения, либо фактическое время, когда они были высажены.

TripWaypoint

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

TripWaypoint

Это поле поддерживает ручной заказ путевых точек для поездки. Он содержит все оставшиеся путевые точки для назначенного транспортного средства, а также путевые точки посадки и высадки для этой поездки. Если поездка не назначена транспортному средству, Fleet Engine игнорирует это поле. По соображениям конфиденциальности это поле заполняется сервером только при вызовах UpdateTrip и CreateTrip , а НЕ при вызовах GetTrip .

LatLng

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

string

Только вывод. Закодированный путь к следующей путевой точке.

Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK. Декодирование пока не поддерживается.

Timestamp

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

Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK.

ConsumableTrafficPolyline

Только вывод. Указывает условия трафика на current_route_segment , когда они доступны.

Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK.

Timestamp

Только вывод. Указывает, когда в последний раз был изменен current_route_segment_traffic .

Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK.

TripWaypoint

Только вывод. Маршрутная точка, где заканчивается current_route_segment .

Int32Value

Только вывод. Оставшееся расстояние поездки в поле current_route_segment . Значение не указывается, если поездка не назначена транспортному средству или поездка завершена или отменена.

Timestamp

Только вывод. Расчетное время прибытия до следующей путевой точки (первая запись в поле remaining_waypoints ). Значение не указывается, если поездка не закреплена за транспортным средством или поездка неактивна (завершена или отменена).

Duration

Только вывод. Продолжительность с момента возврата данных Trip до времени в Trip.eta_to_first_waypoint . Значение не указывается, если поездка не закреплена за транспортным средством или поездка неактивна (завершена или отменена).

Timestamp

Только вывод. Указывает, когда в последний раз изменялись remaining_waypoints (путевая точка была добавлена, удалена или изменена).

Timestamp

Только вывод. Указывает, когда в последний раз были изменены remaining_waypoints.path_to_waypoint и remaining_waypoints.traffic_to_waypoint . Ваше клиентское приложение должно кэшировать это значение и передать его в GetTripRequest чтобы гарантировать, что пути и трафик для remaining_waypoints возвращаются только в случае обновления.

int32

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

VehicleLocation

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

bool

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

TripView

Подмножество заполняемых полей «Поездка» и их интерпретация.

TerminalLocation

Местоположение этой путевой точки.

string

Поездка, связанная с этой путевой точкой.

WaypointType

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

LatLng

Путь от предыдущей путевой точки до текущей. Не определено для первой путевой точки в списке. Это поле заполняется только по запросу.

string

Закодированный путь от предыдущей путевой точки до текущей.

Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK. Декодирование пока не поддерживается.

ConsumableTrafficPolyline

Условия дорожного движения на пути к этой путевой точке. Обратите внимание, что трафик доступен только для клиентов Google Map Platform Rides and Delivery Solution.

Int32Value

Расстояние пути от предыдущей путевой точки до текущей путевой точки. Не определено для первой путевой точки в списке.

Timestamp

Расчетное время прибытия в эту точку. Не определено для первой путевой точки в списке.

Duration

Время в пути от предыдущей точки маршрута до этой точки. Не определено для первой путевой точки в списке.

RequestHeader

Стандартный заголовок запроса Fleet Engine.

string

Необходимый. Должно быть в формате providers/{provider}/trips/{trip} . Поставщиком должен быть идентификатор проекта (например, sample-consumer-project ) проекта Google Cloud, участником которого является сервисный аккаунт, выполняющий этот вызов.

Trip

Необходимый. Поездка, связанная с обновлением.

Следующие поля поддерживаются Fleet Engine. Не обновляйте их с помощью Trip.update.

• current_route_segment
• current_route_segment_end_point
• current_route_segment_traffic
• current_route_segment_traffic_version
• current_route_segment_version
• dropoff_time
• eta_to_next_waypoint
• intermediate_destinations_version
• last_location
• name
• number_of_passengers
• pickup_time
• remaining_distance_meters
• remaining_time_to_first_waypoint
• remaining_waypoints
• remaining_waypoints_version
• route

Когда вы обновляете Trip.vehicle_id для совместной поездки, вы должны предоставить список Trip.vehicle_waypoints , чтобы указать порядок оставшихся путевых точек, в противном случае порядок будет неопределенным.

Когда вы указываете Trip.vehicle_waypoints , список должен содержать все оставшиеся путевые точки поездок транспортного средства без каких-либо дополнительных путевых точек. Вы должны расположить эти путевые точки таким образом, чтобы для данной поездки точка посадки находилась перед промежуточными пунктами назначения, а все промежуточные пункты назначения находились перед точкой высадки. Путевые точки EXCLUSIVE поездки не должны пересекаться с другими поездками. Поля trip_id , waypoint_type и location используются, а все остальные поля TripWaypoint в vehicle_waypoints игнорируются.

Чтобы избежать состояния гонки для поездок с несколькими пунктами назначения, вы должны указать Trip.intermediate_destinations_version при обновлении статуса поездки на ENROUTE_TO_INTERMEDIATE_DESTINATION . Передаваемая Trip.intermediate_destinations_version должна соответствовать версии Fleet Engine. Если это не так, запрос не выполняется.

FieldMask

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

RequestHeader

Стандартный заголовок запроса Fleet Engine.

string

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

VehicleAttribute

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

VehicleAttribute

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

RequestHeader

Стандартный заголовок запроса Fleet Engine.

string

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

Vehicle

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

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

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

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

FieldMask

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

string

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

VehicleState

Состояние автомобиля.

TripType

Типы поездок, поддерживаемые этим автомобилем.

string

Только вывод. Список trip_id для поездок, назначенных в данный момент этому транспортному средству.

VehicleLocation

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

int32

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

VehicleAttribute

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

VehicleType

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

LicensePlate

Информация о номерном знаке автомобиля.

TerminalLocation

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

string

Поломная линия, определяющая маршрут, по которому приложение водителя намерено пройти до следующей путевой точки. Этот список также возвращается в Trip.current_route_segment для всех активных поездок, назначенных транспортному средству.

Примечание. Это поле предназначено только для использования Driver SDK. Декодирование пока не поддерживается.

TrafficPolylineData

Только ввод. Fleet Engine использует эту информацию для улучшения обмена информацией о поездках. Примечание. Это поле предназначено только для использования Driver SDK.

Timestamp

Только вывод. Время установки current_route_segment . Он может храниться клиентом и передаваться в будущих запросах GetVehicle , чтобы предотвратить возвращение маршрутов, которые не изменились.

TripWaypoint

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

Int32Value

Оставшееся расстояние поездки для current_route_segment . Это значение также возвращается в Trip.remaining_distance_meters для всех активных поездок, назначенных транспортному средству. Значение не указано, если поле current_route_segment пусто.

Timestamp

Расчетное время прибытия до первой записи в поле waypoints . Значение не указано, если поле waypoints пусто или поле Vehicle.current_route_segment пусто.

При обновлении транспортного средства remaining_time_seconds имеет приоритет над eta_to_first_waypoint в том же запросе.

Int32Value

Только ввод. Оставшееся время в пути для current_route_segment . Значение не указано, если поле waypoints пусто или поле Vehicle.current_route_segment пусто. Это значение должно соответствовать eta_to_first_waypoint - current_time , если все стороны используют одни и те же часы.

При обновлении транспортного средства remaining_time_seconds имеет приоритет над eta_to_first_waypoint в том же запросе.

TripWaypoint

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

Timestamp

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

bool

Указывает, согласен ли водитель на двусторонние поездки. Если true , SearchVehicles может включать транспортное средство, даже если оно в настоящее время назначено для поездки. Значение по умолчанию — false .

NavigationStatus

Статус навигации автомобиля.

DeviceSettings

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

Category

Категория типа транспортного средства

string

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

string

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

string

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

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

bool

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

double

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

VehicleAttribute

Список атрибутов в этой коллекции.

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

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

LocationSensor

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

BoolValue

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

BoolValue

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

Int32Value

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

Int32Value

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

LatLng

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

Timestamp

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

LocationSensor

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

DoubleValue

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

LatLng

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

Timestamp

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

LocationSensor

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

DoubleValue

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

bool

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

Vehicle

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

Timestamp

Расчетное время прибытия автомобиля до пункта выдачи, указанного в заявке. Пустое значение указывает на сбой в расчете ETA для транспортного средства. Если SearchVehiclesRequest.include_back_to_back имеет значение true и у этого транспортного средства есть активная поездка, vehicle_pickup_eta включает время, необходимое для завершения текущей активной поездки.

Int32Value

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

Int32Value

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

Timestamp

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

Int32Value

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

TripType

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

Waypoint

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

VehicleMatchType

Тип автомобиля соответствует.

VehicleMatchOrder

Запрошенный заказ на сортировку транспортных средств соответствует.

VehicleMatchOrder

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

RoadStretch

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

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

Style

Необходимый. Применяемый стиль.

int32

Необходимый. Стиль следует применять между [offset_meters, offset_meters + length_meters) .

int32

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

LatLng

Местоположение этой путевой точки.

Timestamp

Расчетное время прибытия транспортного средства в эту точку маршрута.