Индекс
-
TripService
(интерфейс) -
VehicleService
(интерфейс) -
BatteryInfo
(сообщение) -
BatteryStatus
(перечисление) -
BillingPlatformIdentifier
(перечисление) -
ConsumableTrafficPolyline
(сообщение) -
CreateTripRequest
(сообщение) -
CreateVehicleRequest
(сообщение) -
DeviceSettings
(сообщение) -
GetTripRequest
(сообщение) -
GetVehicleRequest
(сообщение) -
LicensePlate
(сообщение) -
ListVehiclesRequest
(сообщение) -
ListVehiclesResponse
(сообщение) -
LocationPowerSaveMode
(перечисление) -
LocationSensor
(перечисление) -
NavigationStatus
(перечисление) -
PolylineFormatType
(перечисление) -
PowerSource
(перечисление) -
ReportBillableTripRequest
(сообщение) -
ReportBillableTripRequest.SolutionType
(перечисление) -
RequestHeader
(сообщение) -
RequestHeader.Platform
(перечисление) -
RequestHeader.SdkType
(перечисление) -
SearchTripsRequest
(сообщение) -
SearchTripsResponse
(сообщение) -
SearchVehiclesRequest
(сообщение) -
SearchVehiclesRequest.CurrentTripsPresent
(перечисление) -
SearchVehiclesRequest.VehicleMatchOrder
(перечисление) -
SearchVehiclesResponse
(сообщение) -
SpeedReadingInterval
(сообщение) -
SpeedReadingInterval.Speed
(перечисление) -
StopLocation
(сообщение) -
TerminalLocation
(сообщение) -
TerminalPointId
(сообщение) (устарело) -
TrafficPolylineData
(сообщение) -
Trip
(сообщение) -
TripStatus
(перечисление) -
TripType
(перечисление) -
TripView
(перечисление) -
TripWaypoint
(сообщение) -
UpdateTripRequest
(сообщение) -
UpdateVehicleAttributesRequest
(сообщение) -
UpdateVehicleAttributesResponse
(сообщение) -
UpdateVehicleRequest
(сообщение) -
Vehicle
(сообщение) -
Vehicle.VehicleType
(сообщение) -
Vehicle.VehicleType.Category
(перечисление) -
VehicleAttribute
(сообщение) -
VehicleAttributeList
(сообщение) -
VehicleLocation
(сообщение) -
VehicleMatch
(сообщение) -
VehicleMatch.VehicleMatchType
(перечисление) -
VehicleState
(перечисление) -
VisualTrafficReportPolylineRendering
(сообщение) -
VisualTrafficReportPolylineRendering.RoadStretch
(сообщение) -
VisualTrafficReportPolylineRendering.RoadStretch.Style
(перечисление) -
Waypoint
(сообщение) -
WaypointType
(перечисление)
ТрипСервис
Служба организации поездок.
Создать поездку |
---|
Создает поездку в Fleet Engine и возвращает новую поездку. |
GetTrip |
---|
Получите информацию об одной поездке. |
ОтчетОплачиваемая поездка |
---|
Отчет об использовании оплачиваемых поездок. |
Поискпоездок |
---|
Получите все поездки для конкретного автомобиля. |
ОбновлениеTrip |
---|
Обновляет данные о поездке. |
АвтомобильСервис
Служба управления транспортным средством.
Создать транспортное средство |
---|
Создает экземпляр нового транспортного средства, связанного с поставщиком услуг совместного использования поездок или доставки по требованию. Каждое При создании
Следующие поля
Все остальные поля являются необязательными и используются, если они предусмотрены. |
Получить транспортное средство |
---|
Возвращает транспортное средство из Fleet Engine. |
СписокТранспорта |
---|
Возвращает постраничный список транспортных средств, связанных с поставщиком, которые соответствуют параметрам запроса. |
Поиск транспортных средств |
---|
Возвращает список транспортных средств, соответствующих параметрам запроса. |
Обновить транспортное средство |
---|
Записывает обновленные данные автомобиля в Fleet Engine. При обновлении
Если поле |
Обновление атрибутов транспортного средства |
---|
Частично обновляет характеристики автомобиля. Будут обновлены только атрибуты, указанные в запросе, остальные атрибуты НЕ будут изменены. Примечание. В |
Информация о батарее
Информация об аккумуляторе устройства.
Поля | |
---|---|
battery_status | Состояние аккумулятора: полный или заряжающийся и т. д. |
power_source | Состояние источника питания аккумулятора. |
battery_percentage | Текущий процент заряда батареи [0-100]. |
Статус батареи
Состояние аккумулятора: полный или заряжающийся и т. д.
Перечисления | |
---|---|
UNKNOWN_BATTERY_STATUS | Состояние батареи неизвестно. |
BATTERY_STATUS_CHARGING | Аккумулятор заряжается. |
BATTERY_STATUS_DISCHARGING | Аккумулятор разряжается. |
BATTERY_STATUS_FULL | Аккумулятор заряжен. |
BATTERY_STATUS_NOT_CHARGING | Аккумулятор не заряжается. |
BATTERY_STATUS_POWER_LOW | Батарея разряжена. |
Идентификатор биллинговой платформы
Набор значений, указывающих, на какой платформе был отправлен запрос.
Перечисления | |
---|---|
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED | По умолчанию. Используется для неуказанных платформ. |
SERVER | Платформа представляет собой клиент-сервер. |
WEB | Платформа представляет собой веб-браузер. |
ANDROID | Платформа представляет собой мобильное устройство Android. |
IOS | Платформа представляет собой мобильное устройство IOS. |
OTHERS | Другие платформы, не указанные в этом списке. |
Расходные материалыТрафикПолилиния
Плотность движения на пути движения транспортного средства.
Поля | |
---|---|
speed_reading_interval[] | Скорость движения на пути от предыдущей путевой точки до текущей. |
encoded_path_to_waypoint | Путь, который следует водителю от предыдущей точки маршрута до текущей точки маршрута. На этом пути есть ориентиры, поэтому клиенты могут показывать маркеры трафика вдоль пути (см. |
Создать запрос на поездку
Сообщение запроса CreateTrip.
Поля | |
---|---|
header | Стандартный заголовок запроса Fleet Engine. |
parent | Необходимый. Должно быть в формате |
trip_id | Необходимый. Уникальный идентификатор поездки. С учетом следующих ограничений:
|
trip | Необходимый. Объект поездки, который нужно создать. При создании поездки обязательны следующие поля:
Следующие поля используются, если вы их предоставите:
Все остальные поля «Поездка» игнорируются. Например, все поездки начинаются со Только Если для общей поездки задан Когда вы указываете Поля |
Создать запрос транспортного средства
Сообщение запроса CreateVehicle
.
Поля | |
---|---|
header | Стандартный заголовок запроса Fleet Engine. |
parent | Необходимый. Должно быть в формате |
vehicle_id | Необходимый. Уникальный идентификатор автомобиля. С учетом следующих ограничений:
|
vehicle | Необходимый. Объект Транспортное средство, который необходимо создать. При создании ТС обязательны следующие поля:
При создании ТС игнорируются следующие поля:
Все остальные поля являются необязательными и используются, если они предусмотрены. |
Настройки устройства
Информация о различных настройках мобильного устройства.
Поля | |
---|---|
location_power_save_mode | Как функции определения местоположения настроены на работу на устройстве, когда включен режим экономии заряда батареи. |
is_power_save_mode | Находится ли устройство в режиме энергосбережения. |
is_interactive | Находится ли устройство в интерактивном состоянии. |
battery_info | Информация о состоянии батареи. |
Получить запрос поездки
Сообщение запроса GetTrip.
Поля | |
---|---|
header | Стандартный заголовок запроса Fleet Engine. |
name | Необходимый. Должно быть в формате |
view | Подмножество полей Trip, которые должны быть возвращены, и их интерпретация. |
current_route_segment_version | Указывает минимальную временную метку (эксклюзивную), для которой извлекаются данные |
remaining_waypoints_version | Указывает минимальную временную метку (эксклюзивную), для которой извлекаются |
route_format_type | Возвращаемый формат текущего маршрута: |
current_route_segment_traffic_version | Указывает минимальную временную метку (эксклюзивную), для которой извлекается |
remaining_waypoints_route_version | Указывает минимальную временную метку (эксклюзивную), для которой извлекаются данные |
Получить запрос транспортного средства
Сообщение запроса GetVehicle
.
Поля | |
---|---|
header | Стандартный заголовок запроса Fleet Engine. |
name | Необходимый. Должно быть в формате |
current_route_segment_version | Указывает минимальную временную метку (эксклюзивную), для которой извлекается |
waypoints_version | Указывает минимальную временную метку (эксклюзивную), для которой извлекаются данные |
Лицензионная Табличка
Информация о номерном знаке ТС. Чтобы избежать хранения информации, позволяющей установить личность, как часть объекта хранится только минимальная информация о номерном знаке.
Поля | |
---|---|
country_code | Необходимый. Код страны/региона CLDR. Например, |
last_character | Последняя цифра номерного знака или «-1», обозначающая отсутствие числового значения, присутствует в номерном знаке.
|
Список транспортных средствЗапрос
Сообщение запроса ListVehicles
.
Поля | |
---|---|
header | Стандартный заголовок запроса Fleet Engine. |
parent | Необходимый. Должно быть в формате |
page_size | Максимальное количество возвращаемых автомобилей. Значение по умолчанию: 100. |
page_token | Значение |
minimum_capacity | Указывает необходимую минимальную грузоподъемность автомобиля. Все возвращенные транспортные средства будут иметь |
trip_types[] | Ограничивает ответ транспортными средствами, которые поддерживают хотя бы один из указанных типов поездок. |
maximum_staleness | Ограничивает ответ транспортными средствами, которые отправили обновления местоположения в Fleet Engine в течение указанного периода времени. Стационарные транспортные средства, все еще передающие свое местоположение, не считаются устаревшими. Если присутствует, должна быть действительная положительная продолжительность. |
vehicle_type_categories[] | Необходимый. Ограничивает ответ транспортными средствами одной из указанных типовых категорий. |
required_attributes[] | Вызывающие программы могут формировать сложные логические операции, используя любую комбинацию полей
Ограничивает ответ транспортными средствами с указанными атрибутами. Это поле представляет собой операцию конъюнкции/И. Разрешается максимум 50 обязательных_атрибутов. Это соответствует максимальному количеству атрибутов, разрешенных для транспортного средства. Каждая повторяющаяся строка должна иметь формат «ключ:значение». |
required_one_of_attributes[] | Ограничивает ответ транспортными средствами, имеющими хотя бы один из указанных атрибутов в каждом |
required_one_of_attribute_sets[] | Подобно
Ограничивает ответ транспортными средствами, которые соответствуют всем атрибутам в |
vehicle_state | Ограничивает ответ транспортными средствами, имеющими это состояние. |
on_trip_only | Возвращайте только автомобили с текущей поездкой(ями). |
filter | Необязательный. Запрос-фильтр, применяемый при перечислении транспортных средств. См. http://aip.dev/160 для примеров синтаксиса фильтра. Это поле предназначено для замены полей Этот фильтр работает как предложение AND с другими ограничениями, такими как Обратите внимание, что поддерживаются только запросы по атрибутам транспортного средства (например, Кроме того, все атрибуты хранятся в виде строк, поэтому единственным поддерживаемым сравнением атрибутов является сравнение строк. Для сравнения с числовыми или логическими значениями значения должны быть явно заключены в кавычки, чтобы их можно было рассматривать как строки (например, |
viewport | Необязательный. Фильтр, который ограничивает количество транспортных средств, возвращаемых теми, чье последнее известное местоположение находилось в прямоугольной области, определенной окном просмотра. |
Список транспортных средствОтвет
Ответное сообщение ListVehicles
.
Поля | |
---|---|
vehicles[] | Транспортные средства, соответствующие критериям запроса. Максимальное количество возвращаемых автомобилей определяется полем |
next_page_token | Токен для получения следующей страницы транспортных средств или пустой, если транспортных средств, соответствующих критериям запроса, больше нет. |
total_size | Необходимый. Общее количество автомобилей, соответствующих критериям запроса на всех страницах. |
МестоположениеPowerSaveMode
Как функции определения местоположения настраиваются на мобильном устройстве, когда на устройстве включена функция экономии заряда батареи. ( https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode() )
Перечисления | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE | Неопределенное местоположениеPowerSaveMode |
LOCATION_MODE_NO_CHANGE | Либо режим экономии заряда не должен влиять на провайдеров определения местоположения, либо режим экономии заряда отключен. |
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF | Поставщик местоположения на основе GPS должен быть отключен, когда включена экономия заряда батареи и устройство неинтерактивно. |
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF | Все поставщики геолокации должны быть отключены, когда включена экономия заряда батареи и устройство неинтерактивно. |
LOCATION_MODE_FOREGROUND_ONLY | Все поставщики местоположений останутся доступными, но исправления местоположения следует предоставлять только приложениям на переднем плане. |
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF | Местоположение не будет отключено, но LocationManager будет регулировать все запросы к поставщикам, когда устройство неинтерактивно. |
Датчик местоположения
Датчик или метод, используемый для определения местоположения.
Перечисления | |
---|---|
UNKNOWN_SENSOR | Датчик не указан или неизвестен. |
GPS | GPS или вспомогательный GPS. |
NETWORK | Вспомогательный GPS, идентификатор вышки сотовой связи или точка доступа Wi-Fi. |
PASSIVE | Идентификатор сотовой вышки или точки доступа Wi-Fi. |
ROAD_SNAPPED_LOCATION_PROVIDER | Местоположение, определенное мобильным устройством как наиболее вероятное положение на дороге. |
CUSTOMER_SUPPLIED_LOCATION | Местоположение, предоставленное клиентом из независимого источника. Обычно это значение используется для местоположения, предоставленного из источников, отличных от мобильного устройства, на котором работает Driver SDK. Если исходный источник описан одним из других значений перечисления, используйте это значение. Местоположение с пометкой CUSTOMER_SUPPLIED_LOCATION обычно предоставляется через last_location.supplemental_location_sensor транспортного средства. |
FLEET_ENGINE_LOCATION | Местоположение, рассчитанное Fleet Engine на основе доступных ему сигналов. Только вывод. Это значение будет отклонено, если оно получено в запросе. |
FUSED_LOCATION_PROVIDER | Поставщик Fused Location для Android. |
CORE_LOCATION | Поставщик местоположения в операционных системах Apple. |
ПолилинияФорматТип
Тип формата полилинии.
Перечисления | |
---|---|
UNKNOWN_FORMAT_TYPE | Формат не указан или неизвестен. |
LAT_LNG_LIST_TYPE | Список google.type.LatLng . |
ENCODED_POLYLINE_TYPE | Полилиния, закодированная с помощью алгоритма сжатия полилиний. Декодирование пока не поддерживается. |
Источник питания
Тип зарядного устройства, используемого для зарядки аккумулятора.
Перечисления | |
---|---|
UNKNOWN_POWER_SOURCE | Источник питания неизвестен. |
POWER_SOURCE_AC | Источником питания является зарядное устройство переменного тока. |
POWER_SOURCE_USB | Источником питания является USB-порт. |
POWER_SOURCE_WIRELESS | Источник питания беспроводной. |
POWER_SOURCE_UNPLUGGED | Аккумулятор отключен. |
ОтчетОплачиваемая поездкаЗапрос
Сообщение с запросом ReportBillableTrip.
Поля | |
---|---|
name | Необходимый. Должно быть в формате |
country_code | Необходимый. Двухбуквенный код страны, куда состоится поездка. Цена определяется в соответствии с кодом страны. |
platform | Платформа, на которой был отправлен запрос. |
related_ids[] | Идентификаторы, которые напрямую связаны с сообщаемой поездкой. Обычно это идентификаторы (например, идентификаторы сеансов) операций предварительного бронирования, выполненных до того, как идентификатор поездки станет доступен. Количество |
solution_type | Тип решения по продукту GMP (например, |
Тип решения
Селектор для различных типов решения отчетной поездки.
Перечисления | |
---|---|
SOLUTION_TYPE_UNSPECIFIED | Значение по умолчанию. Для обеспечения обратной совместимости API по умолчанию будет использовать ON_DEMAND_RIDESHARING_AND_DELIVERIES , который является первым поддерживаемым типом решения. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES | Решение — поездка по запросу с доставкой. |
Заголовок запроса
RequestHeader содержит поля, общие для всех запросов RPC Fleet Engine.
Поля | |
---|---|
language_code | Код языка BCP-47, например en-US или sr-Latn. Для получения дополнительной информации см. http://www.unicode.org/reports/tr35/#Unicode_locale_identifier . Если ничего не указано, ответ может быть на любом языке, предпочтительно на английском языке, если такое имя существует. Пример значения поля: |
region_code | Необходимый. CLDR-код региона, откуда исходит запрос. Пример значения поля: |
sdk_version | Версия вызывающего SDK, если применимо. Формат версии — «major.minor.patch», пример: |
os_version | Версия операционной системы, в которой работает вызывающий SDK. Примеры значений полей: |
device_model | Модель устройства, на котором запущен вызывающий SDK. Примеры значений полей: |
sdk_type | Тип SDK, отправляющего запрос. |
maps_sdk_version | Версия MapSDK, от которой зависит вызывающий SDK, если применимо. Формат версии — «major.minor.patch», пример: |
nav_sdk_version | Версия NavSDK, от которой зависит вызывающий SDK, если применимо. Формат версии — «major.minor.patch», пример: |
platform | Платформа вызывающего SDK. |
manufacturer | Производитель устройства Android из вызывающего SDK, применимо только для Android SDK. Пример значения поля: |
android_api_level | Уровень Android API вызывающего SDK, применим только для Android SDK. Пример значения поля: |
trace_id | Необязательный идентификатор, который можно указать для целей регистрации, чтобы идентифицировать запрос. |
Платформа
Платформа вызывающего SDK.
Перечисления | |
---|---|
PLATFORM_UNSPECIFIED | Значение по умолчанию. Это значение используется, если платформа опущена. |
ANDROID | Запрос поступает от Android. |
IOS | Запрос поступает от iOS. |
WEB | Запрос поступает из Интернета. |
Тип Сдк
Возможные типы SDK.
Перечисления | |
---|---|
SDK_TYPE_UNSPECIFIED | Значение по умолчанию. Это значение используется, если sdk_type опущен. |
CONSUMER | Вызывающий SDK — Consumer. |
DRIVER | Вызывающий SDK — Driver. |
JAVASCRIPT | Вызывающий SDK — это JavaScript. |
ПоискПоездкиЗапрос
Сообщение с запросом SearchTrips.
Поля | |
---|---|
header | Стандартный заголовок запроса Fleet Engine. |
parent | Необходимый. Должно быть в формате |
vehicle_id | Транспортное средство, связанное с поездками в запросе. Если не указано, возвращенные поездки не содержат:
|
active_trips_only | Если установлено значение true, ответ включает поездки, влияющие на маршрут водителя. |
page_size | Если не установлено, сервер определяет количество возвращаемых результатов. |
page_token | Установите для этого значения значение, ранее возвращенное в |
minimum_staleness | Если указано, возвращает поездки, которые не были обновлены по истечении времени |
ПоискПоездкиОтвет
Ответное сообщение SearchTrips.
Поля | |
---|---|
trips[] | Список поездок для запрошенного автомобиля. |
next_page_token | Передайте этот токен в SearchTripsRequest для пролистывания результатов списка. API возвращает список поездок при каждом вызове, и когда результатов больше не остается, список поездок пуст. |
ПоискТранспортЗапрос
Сообщение запроса SearchVehicles
.
Поля | |
---|---|
header | Стандартный заголовок запроса Fleet Engine. |
parent | Необходимый. Должно быть в формате |
pickup_point | Необходимый. Пункт выдачи, который нужно искать рядом. |
dropoff_point | Предполагаемое место высадки клиента. Поле является обязательным, если |
pickup_radius_meters | Необходимый. Определяет радиус поиска автомобиля вокруг точки посадки. Возврату подлежат только транспортные средства, находящиеся в радиусе поиска. Значение должно быть от 400 до 10 000 метров (включительно). |
count | Необходимый. Указывает максимальное количество возвращаемых транспортных средств. Значение должно находиться в диапазоне от 1 до 50 (включительно). |
minimum_capacity | Необходимый. Указывает количество пассажиров, рассматриваемых для поездки. Значение должно быть больше или равно единице. Драйвер не учитывается в значении емкости. |
trip_types[] | Необходимый. Представляет тип предлагаемой поездки. Должен включать ровно один тип. |
maximum_staleness | Ограничивает поиск только теми транспортными средствами, которые отправили обновления местоположения в Fleet Engine в течение указанного периода. Стационарные транспортные средства, все еще передающие свое местоположение, не считаются устаревшими. Если это поле не задано, сервер использует пять минут в качестве значения по умолчанию. |
vehicle_types[] | Необходимый. Ограничивает поиск транспортными средствами одного из указанных типов. Должен быть указан хотя бы один тип транспортного средства. Типы транспортных средств с категорией |
required_attributes[] | Вызывающие программы могут формировать сложные логические операции, используя любую комбинацию полей
Ограничивает поиск только теми транспортными средствами с указанными атрибутами. Это поле представляет собой операцию конъюнкции/И. Разрешается максимум 50 обязательных_атрибутов. Это соответствует максимальному количеству атрибутов, разрешенных для транспортного средства. |
required_one_of_attributes[] | Ограничивает поиск только теми транспортными средствами, у которых есть хотя бы один из указанных атрибутов в каждом |
required_one_of_attribute_sets[] | Подобно
Ограничивает поиск только теми транспортными средствами, которые имеют все атрибуты в |
order_by | Необходимый. Указывает желаемый критерий упорядочения результатов. |
include_back_to_back | Это указывает на то, подходят ли для этого поиска транспортные средства с одной активной поездкой. Это поле используется только в том случае, если Значение по умолчанию — |
trip_id | Указывает поездку, связанную с этим |
current_trips_present | Это указывает на то, подходят ли для этого поиска автомобили с активными поездками. Должно быть установлено значение, отличное от |
filter | Необязательный. Запрос-фильтр, применяемый при поиске транспортных средств. См. http://aip.dev/160 для примеров синтаксиса фильтра. Это поле предназначено для замены полей Этот фильтр работает как предложение AND с другими ограничениями, такими как Обратите внимание, что поддерживаются только запросы по атрибутам транспортного средства (например, Кроме того, все атрибуты хранятся в виде строк, поэтому единственным поддерживаемым сравнением атрибутов является сравнение строк. Для сравнения с числовыми или логическими значениями значения должны быть явно заключены в кавычки, чтобы их можно было рассматривать как строки (например, |
ТекущееПоездкиНастоящее
Определяет типы ограничений на текущие поездки автомобиля.
Перечисления | |
---|---|
CURRENT_TRIPS_PRESENT_UNSPECIFIED | Наличие транспортных средств с рейсами определяется полем include_back_to_back . |
NONE | В результатах поиска могут появиться автомобили без поездок. Когда используется это значение, include_back_to_back не может иметь true . |
ANY | В результаты поиска включаются автомобили, имеющие не более 5 текущих поездок и 10 путевых точек. Когда используется это значение, include_back_to_back не может иметь true . |
Транспортное средствоМатчЗаказ
Указывает порядок совпадений транспортных средств в ответе.
Перечисления | |
---|---|
UNKNOWN_VEHICLE_MATCH_ORDER | По умолчанию, используется для неуказанного или нераспознанного транспортного средства, соответствующего порядку. |
PICKUP_POINT_ETA | В порядке возрастания времени в пути автомобиля до пункта выдачи. |
PICKUP_POINT_DISTANCE | В порядке возрастания расстояния проезда автомобиля до пункта выдачи. |
DROPOFF_POINT_ETA | В порядке возрастания времени движения автомобиля до точки высадки. Этот заказ можно использовать только в том случае, если в запросе указана точка выдачи. |
PICKUP_POINT_STRAIGHT_DISTANCE | В порядке возрастания по расстоянию по прямой от последнего зарегистрированного местоположения автомобиля до точки посадки. |
COST | В порядке возрастания настроенной стоимости соответствия. Стоимость матча определяется как взвешенный расчет расстояния по прямой и расчетного времени прибытия. Веса устанавливаются со значениями по умолчанию и могут быть изменены для каждого клиента. Если эти веса необходимо изменить для вашего проекта, обратитесь в службу поддержки Google. |
ПоискТранспортОтвет
Ответное сообщение SearchVehicles
.
Поля | |
---|---|
matches[] | Список транспортных средств, соответствующих критериям |
СкоростьЧтенияИнтервал
Индикатор плотности движения на непрерывном участке пути. Учитывая путь с точками P_0, P_1,..., P_N (индекс, начинающийся с нуля), SpeedReadingInterval определяет интервал и описывает его трафик, используя следующие категории.
Поля | |
---|---|
start_polyline_point_index | Начальный индекс этого интервала в пути. В JSON, когда индекс равен 0, поле будет незаполненным. |
end_polyline_point_index | Конечный индекс этого интервала в пути. В JSON, когда индекс равен 0, поле будет незаполненным. |
speed | Скорость движения в этом интервале. |
Скорость
Классификация скорости полилинии на основе данных о трафике.
Перечисления | |
---|---|
SPEED_UNSPECIFIED | Значение по умолчанию. Это значение не используется. |
NORMAL | Скорость нормальная, замедлений не обнаружено. |
SLOW | Замедление зафиксировано, но пробки не образовалось. |
TRAFFIC_JAM | Обнаружена пробка. |
ОстановитьМестоположение
Фактическое место, где произошла остановка (посадка/высадка).
Поля | |
---|---|
point | Необходимый. Обозначает фактическое местоположение. |
timestamp | Указывает, когда произошла остановка. |
stop_time | Только ввод. Устарело. Используйте поле отметки времени. |
ТерминалМестоположение
Описывает местоположение путевой точки.
Поля | |
---|---|
point | Необходимый. Обозначает местоположение путевой точки поездки. |
terminal_point_id | Устарело: вместо этого укажите поле |
access_point_id | Устарело: вместо этого укажите поле |
trip_id | Устарело. |
terminal_location_type | Устарело: эти данные будут содержаться |
Терминалпоинтид
Устарело: точки TerminalPoints больше не поддерживаются в Fleet Engine. Вместо этого используйте TerminalLocation.point
.
Поля | |
---|---|
value | Устарело. |
Id поля объединения. Устарело. Id может быть только одним из следующих: | |
place_id | Устарело. |
generated_id | Устарело. |
ТрафикПолилинияДанные
Условия дорожного движения по предполагаемому маршруту движения транспортного средства.
Поля | |
---|---|
traffic_rendering | Полилинейное отображение скорости движения во всех регионах на одном участке поездки клиента. |
Путешествие
Метаданные поездки.
Поля | |
---|---|
name | Только вывод. В формате "провайдеры/{провайдер}/поездки/{поездка}" |
vehicle_id | Идентификатор транспортного средства, совершающего эту поездку. |
trip_status | Текущий статус поездки. |
trip_type | Тип поездки. |
pickup_point | Место, где клиент укажет, что его заберут. |
actual_pickup_point | Только ввод. Фактическое место, когда и где забрали клиента. Это поле предназначено для того, чтобы поставщик предоставил отзыв о фактической информации о получении. |
actual_pickup_arrival_point | Только ввод. Фактическое время и место прибытия водителя в пункт выдачи. Это поле предназначено для предоставления поставщиком информации о фактическом прибытии в пункт выдачи. |
pickup_time | Только вывод. Либо предполагаемое время в будущем, когда гонщика(ов) заберут, либо фактическое время, когда их заберут. |
intermediate_destinations[] | Промежуточные остановки в соответствии с запросами на поездку (помимо посадки и высадки). Первоначально эта функция не будет поддерживаться для совместных поездок. |
intermediate_destinations_version | Указывает, когда в последний раз было изменено |
intermediate_destination_index | Когда |
actual_intermediate_destination_arrival_points[] | Только ввод. Фактическое время и место прибытия водителя в промежуточный пункт назначения. Это поле предназначено для предоставления поставщиком информации о фактическом прибытии в промежуточные пункты назначения. |
actual_intermediate_destinations[] | Только ввод. Фактическое время и место, когда и где клиента забрали из промежуточного пункта назначения. Это поле предназначено для предоставления поставщиком обратной связи о фактической информации о получении в промежуточных пунктах назначения. |
dropoff_point | Место, где клиент указывает, что его высадят. |
actual_dropoff_point | Только ввод. Фактическое время и место, когда и где высадили клиента. Это поле предназначено для предоставления поставщиком обратной связи по фактической информации о возврате. |
dropoff_time | Только вывод. Либо предполагаемое будущее время, когда пассажир(ы) будут высажены в конечном пункте назначения, либо фактическое время, когда они были высажены. |
remaining_waypoints[] | Только вывод. Полный путь от текущего местоположения до точки высадки включительно. Этот путь может включать путевые точки из других поездок. |
vehicle_waypoints[] | Это поле поддерживает ручной заказ путевых точек для поездки. Он содержит все оставшиеся путевые точки для назначенного транспортного средства, а также путевые точки посадки и высадки для этой поездки. Если поездка не назначена транспортному средству, Fleet Engine игнорирует это поле. По соображениям конфиденциальности это поле заполняется сервером только при вызовах |
route[] | Только вывод. Предполагаемый маршрут этой поездки до первой записи в rest_waypoints. Обратите внимание, что первая путевая точка может принадлежать другому рейсу. |
current_route_segment | Только вывод. Закодированный путь к следующей путевой точке. Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK. Декодирование пока не поддерживается. |
current_route_segment_version | Только вывод. Указывает последний раз, когда маршрут был изменен. Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK. |
current_route_segment_traffic | Только вывод. Указывает условия трафика на Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK. |
current_route_segment_traffic_version | Только вывод. Указывает, когда в последний раз был изменен Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK. |
current_route_segment_end_point | Только вывод. Маршрутная точка, где заканчивается |
remaining_distance_meters | Только вывод. Оставшееся расстояние поездки в поле |
eta_to_first_waypoint | Только вывод. Расчетное время прибытия до следующей путевой точки (первая запись в поле |
remaining_time_to_first_waypoint | Только вывод. Продолжительность с момента возврата данных Trip до времени в |
remaining_waypoints_version | Только вывод. Указывает, когда в последний раз изменялись |
remaining_waypoints_route_version | Только вывод. Указывает, когда в последний раз были изменены |
number_of_passengers | Неизменяемый. Указывает количество пассажиров в поездке, не включая водителя. Транспортное средство должно иметь доступную вместимость, чтобы быть возвращенным в ответе |
last_location | Только вывод. Указывает последнее зарегистрированное местоположение транспортного средства на маршруте. |
last_location_snappable | Только вывод. Указывает, можно ли привязать |
view | Подмножество заполняемых полей «Поездка» и их интерпретация. |
Статус поездки
Статус поездки с указанием ее хода.
Перечисления | |
---|---|
UNKNOWN_TRIP_STATUS | По умолчанию, используется для неуказанного или нераспознанного статуса отключения. |
NEW | Недавно созданная поездка. |
ENROUTE_TO_PICKUP | Водитель направляется к месту посадки. |
ARRIVED_AT_PICKUP | Водитель прибыл в пункт выдачи. |
ARRIVED_AT_INTERMEDIATE_DESTINATION | Водитель прибыл в промежуточный пункт назначения и ждет пассажира. |
ENROUTE_TO_INTERMEDIATE_DESTINATION | Водитель находится на пути к промежуточному пункту назначения (не к месту высадки). |
ENROUTE_TO_DROPOFF | Водитель подобрал пассажира и направляется к следующему пункту назначения. |
COMPLETE | Гонщика высадили, и поездка завершена. |
CANCELED | Поездка была отменена до ее получения водителем, пассажиром или поставщиком услуг совместного использования поездок. |
Тип поездки
Тип поездки.
Перечисления | |
---|---|
UNKNOWN_TRIP_TYPE | По умолчанию, используется для неуказанных или нераспознанных типов поездок. |
SHARED | В поездке может использоваться совместное транспортное средство с другими поездками. |
EXCLUSIVE | Поездка эксклюзивна на автомобиле. |
ТрипВью
Селектор для различных наборов полей Trip в ответе GetTrip
. Контекст см. в AIP-157 . Вероятно, будут добавлены дополнительные представления.
Перечисления | |
---|---|
TRIP_VIEW_UNSPECIFIED | Значение по умолчанию. Для обеспечения обратной совместимости API по умолчанию использует представление SDK. Чтобы обеспечить стабильность и поддержку, клиентам рекомендуется выбирать TripView отличный от SDK . |
SDK | Включает поля, которые невозможно интерпретировать или поддерживать с помощью общедоступных библиотек. |
JOURNEY_SHARING_V1S | Поля поездки заполняются для варианта использования «Совместное путешествие». Это представление предназначено для связи между серверами. |
ПоездкаПутевая точка
Описывает точку остановки на маршруте транспортного средства или конечную точку поездки.
Поля | |
---|---|
location | Местоположение этой путевой точки. |
trip_id | Поездка, связанная с этой путевой точкой. |
waypoint_type | Роль, которую эта путевая точка играет в этой поездке, например, посадка или высадка. |
path_to_waypoint[] | Путь от предыдущей путевой точки до текущей. Не определено для первой путевой точки в списке. Это поле заполняется только по запросу. |
encoded_path_to_waypoint | Закодированный путь от предыдущей путевой точки до текущей. Примечание. Это поле предназначено только для использования Driver SDK и Consumer SDK. Декодирование пока не поддерживается. |
traffic_to_waypoint | Условия дорожного движения на пути к этой путевой точке. Обратите внимание, что трафик доступен только для клиентов Google Map Platform Rides and Delivery Solution. |
distance_meters | Расстояние пути от предыдущей путевой точки до текущей путевой точки. Не определено для первой путевой точки в списке. |
eta | Расчетное время прибытия в эту точку. Не определено для первой путевой точки в списке. |
duration | Время в пути от предыдущей точки маршрута до этой точки. Не определено для первой путевой точки в списке. |
Обновление запроса на поездку
Сообщение с запросом UpdateTrip.
Поля | |
---|---|
header | Стандартный заголовок запроса Fleet Engine. |
name | Необходимый. Должно быть в формате |
trip | Необходимый. Поездка, связанная с обновлением. Следующие поля поддерживаются Fleet Engine. Не обновляйте их с помощью Trip.update.
Когда вы обновляете Когда вы указываете Чтобы избежать состояния гонки для поездок с несколькими пунктами назначения, вы должны указать |
update_mask | Необходимый. Маска поля, указывающая, какие поля в Trip необходимо обновить. |
Запрос обновления атрибутов транспортного средства
Сообщение запроса UpdateVehicleAttributes
.
Поля | |
---|---|
header | Стандартный заголовок запроса Fleet Engine. |
name | Необходимый. Должно быть в формате |
attributes[] | Необходимый. Атрибуты автомобиля, которые необходимо обновить. Неупомянутые атрибуты не изменяются и не удаляются. |
UpdateVehicleAttributesResponse
Ответное сообщение UpdateVehicleAttributes
.
Поля | |
---|---|
attributes[] | Необходимый. Обновленный полный список атрибутов автомобиля, включая новые, измененные и нетронутые атрибуты. |
Запрос обновления транспортного средства
`Сообщение с запросом UpdateVehicle.
Поля | |
---|---|
header | Стандартный заголовок запроса Fleet Engine. |
name | Необходимый. Должно быть в формате |
vehicle | Необходимый. Значения сущности
Если поле Аналогично, поле |
update_mask | Необходимый. Маска полей, указывающая, какие поля |
Транспортное средство
Метаданные автомобиля.
Поля | |
---|---|
name | Только вывод. Уникальное имя для этого автомобиля. Формат: |
vehicle_state | Состояние автомобиля. |
supported_trip_types[] | Типы поездок, поддерживаемые этим автомобилем. |
current_trips[] | Только вывод. Список |
last_location | Последнее сообщенное местонахождение автомобиля. |
maximum_capacity | Общее количество пассажиров, которое может перевозить этот автомобиль. Драйвер не учитывается в этом значении. Это значение должно быть больше или равно единице. |
attributes[] | Список характеристик автомобиля. Транспортное средство может иметь не более 100 атрибутов, и каждый атрибут должен иметь уникальный ключ. |
vehicle_type | Необходимый. Тип этого автомобиля. Может использоваться для фильтрации транспортных средств в результатах |
license_plate | Информация о номерном знаке автомобиля. |
route[] | Устарело: вместо этого используйте |
current_route_segment | Поломная линия, определяющая маршрут, по которому приложение водителя намерено пройти до следующей путевой точки. Этот список также возвращается в Примечание. Это поле предназначено только для использования Driver SDK. Декодирование пока не поддерживается. |
current_route_segment_traffic | Только ввод. Fleet Engine использует эту информацию для улучшения обмена информацией о поездках. Примечание. Это поле предназначено только для использования Driver SDK. |
current_route_segment_version | Только вывод. Время установки |
current_route_segment_end_point | Маршрутная точка, где заканчивается |
remaining_distance_meters | Оставшееся расстояние поездки для |
eta_to_first_waypoint | Расчетное время прибытия до первой записи в поле При обновлении транспортного средства |
remaining_time_seconds | Только ввод. Оставшееся время в пути для При обновлении транспортного средства |
waypoints[] | Остальные путевые точки назначены этому Транспортному средству. |
waypoints_version | Только вывод. Последний раз поле |
back_to_back_enabled | Указывает, согласен ли водитель на двусторонние поездки. Если |
navigation_status | Статус навигации автомобиля. |
device_settings | Только ввод. Информация о настройках мобильного устройства, используемого водителем. |
Тип транспортного средства
Тип транспортного средства.
Поля | |
---|---|
category | Категория типа транспортного средства |
Категория
Категории типов транспортных средств
Перечисления | |
---|---|
UNKNOWN | По умолчанию, используется для неуказанных или нераспознанных категорий транспортных средств. |
AUTO | Автомобиль. |
TAXI | Любое транспортное средство, выполняющее функции такси (обычно лицензированное или регулируемое). |
TRUCK | Как правило, это автомобиль с большой вместительностью. |
TWO_WHEELER | Мотоцикл, мопед или другое двухколесное транспортное средство. |
BICYCLE | Транспорт, приводимый в движение человеком. |
PEDESTRIAN | Транспортер-человек, обычно идущий или бегущий, передвигающийся по пешеходным дорожкам. |
Атрибут транспортного средства
Описывает атрибут транспортного средства как пару ключ-значение. Длина строки «ключ:значение» не может превышать 256 символов.
Поля | |
---|---|
key | Ключ атрибута. Ключи не могут содержать символ двоеточия (:). |
value | Значение атрибута. |
Поле объединения vehicle_attribute_value . Значение атрибута может иметь строковый, логический или двойной тип. vehicle_attribute_value может быть только одним из следующих: | |
string_value | Значение атрибута строкового типа. Примечание. Это идентично полю |
bool_value | Значение атрибута логического типа. |
number_value | Значение атрибута с двойным типом. |
Список атрибутов транспортного средства
Тип данных «список списков» для атрибутов транспортного средства.
Поля | |
---|---|
attributes[] | Список атрибутов в этой коллекции. |
Транспортное средствоМестоположение
Местоположение, скорость и курс транспортного средства в определенный момент времени.
Поля | |
---|---|
location | Местоположение транспортного средства. Когда данные отправляются в Fleet Engine, местоположение транспортного средства определяется по GPS. Когда вы получите его в ответе, местоположение автомобиля может быть либо местоположением GPS, дополнительным местоположением, либо каким-либо другим предполагаемым местоположением. Источник указан в |
horizontal_accuracy | Устарело: вместо этого используйте |
latlng_accuracy | Точность |
heading | Направление движения автомобиля в градусах. 0 представляет север. Допустимый диапазон: [0,360). |
bearing_accuracy | Устарело: вместо этого используйте |
heading_accuracy | Точность |
altitude | Высота в метрах над WGS84. |
vertical_accuracy | Устарело: вместо этого используйте |
altitude_accuracy | Точность |
speed_kmph | Скорость автомобиля в километрах в час. Устарело: вместо этого используйте |
speed | Скорость автомобиля в метрах/секунду |
speed_accuracy | Точность |
update_time | Время, когда датчик сообщил о |
server_time | Только вывод. Время, когда сервер получил информацию о местоположении. |
location_sensor | Поставщик данных о местоположении (например, |
is_road_snapped | Привязано ли |
is_gps_sensor_enabled | Только ввод. Указывает, включен ли датчик GPS на мобильном устройстве. |
time_since_update | Только ввод. Время (в секундах) с момента первой отправки этого местоположения на сервер. Для первого обновления это значение будет равно нулю. Если время неизвестно (например, при перезапуске приложения), это значение сбрасывается до нуля. |
num_stale_updates | Только ввод. Устарело: теперь для определения устаревшего местоположения используются другие сигналы. |
raw_location | Необработанное местоположение автомобиля (не обработанное дорожным снаппером). |
raw_location_time | Временная метка, связанная с необработанным местоположением. |
raw_location_sensor | Источник исходного местоположения. По умолчанию |
raw_location_accuracy | Точность |
supplemental_location | Дополнительное местоположение, предоставляемое интегрирующим приложением. |
supplemental_location_time | Временная метка, связанная с дополнительным местоположением. |
supplemental_location_sensor | Источник дополнительной локации. По умолчанию |
supplemental_location_accuracy | Точность |
road_snapped | Устарело: вместо этого используйте |
АвтомобильМатч
Содержит транспортное средство и связанные с ним оценки, соответствующие точкам активных поездок для транспортного средства SearchVehiclesRequest
.
Поля | |
---|---|
vehicle | Необходимый. Автомобиль, соответствующий запросу. |
vehicle_pickup_eta | Расчетное время прибытия автомобиля до пункта выдачи, указанного в заявке. Пустое значение указывает на сбой в расчете ETA для транспортного средства. Если |
vehicle_pickup_distance_meters | Расстояние от текущего местоположения Транспортного средства до точки посадки, указанной в запросе, включая любые промежуточные точки посадки или высадки для существующих поездок. Это расстояние включает в себя рассчитанное расстояние вождения (маршрута) плюс расстояние по прямой между конечной точкой навигации и запрошенной точкой посадки. (Расстояние между конечной точкой навигации и запрошенной точкой посадки обычно невелико.) Пустое значение указывает на ошибку при расчете расстояния. |
vehicle_pickup_straight_line_distance_meters | Необходимый. Расстояние по прямой от автомобиля до пункта выдачи, указанного в заявке. |
vehicle_dropoff_eta | Расчетное время прибытия всего транспортного средства до точки выдачи, указанной в запросе. Расчетное время прибытия включает остановку в любых путевых точках до |
vehicle_pickup_to_dropoff_distance_meters | Расстояние движения автомобиля (в метрах) от точки посадки до точки выдачи, указанной в заявке. Расстояние указывается только между двумя точками и не включает в себя местоположение транспортного средства или любые другие точки, которые необходимо посетить до того, как транспортное средство достигнет пункта посадки или пункта высадки. Значение будет заполнено только в том случае, если в запросе указана |
trip_type | Необходимый. Тип поездки запроса, который использовался для расчета расчетного времени прибытия до точки посадки. |
vehicle_trips_waypoints[] | Упорядоченный список путевых точек, используемых для расчета расчетного времени прибытия. В списке указывается местоположение автомобиля, точки получения активных поездок автомобиля, а также точки получения, указанные в запросе. Пустой список указывает на сбой в расчете ETA для автомобиля. |
vehicle_match_type | Тип автомобиля соответствует. |
requested_ordered_by | Запрошенный заказ на сортировку транспортных средств соответствует. |
ordered_by | Фактический порядок, который использовался для этого автомобиля. Обычно это соответствует полю order_by из запроса; однако в определенных обстоятельствах, например, при внутренней ошибке сервера, может использоваться другой метод (например, |
Тип соответствия транспортного средства
Тип автомобиля соответствует.
Перечисления | |
---|---|
UNKNOWN | Неизвестный тип соответствия транспортного средства |
EXCLUSIVE | В настоящее время для автомобиля не назначена поездка, и он может проследовать к месту посадки. |
BACK_TO_BACK | Транспортное средство в настоящее время назначено на поездку, но может проследовать к месту посадки после завершения текущей поездки. Расчеты расчетного времени прибытия и расстояния учитывают существующую поездку. |
CARPOOL | Автомобиль имеет достаточную вместимость для совместной поездки. |
CARPOOL_BACK_TO_BACK | Транспортное средство завершит текущую активную поездку, прежде чем отправиться к месту посадки. Расчеты расчетного времени прибытия и расстояния учитывают существующую поездку. |
Состояние транспортного средства
Состояние Vehicle
.
Перечисления | |
---|---|
UNKNOWN_VEHICLE_STATE | По умолчанию, используется для неуказанных или нераспознанных состояний автомобиля. |
OFFLINE | Транспортное средство не принимает новые поездки. Примечание: в этом состоянии автомобиль может продолжать работу во время выполнения назначенного ему рейса. |
ONLINE | Транспортное средство принимает новые поездки. |
VisualTrafficReportPolylineРендеринг
Описывает, как клиенты должны раскрасить одну часть полилинии вдоль маршрута.
Поля | |
---|---|
road_stretch[] | Необязательный. Участки дороги, которые необходимо отрисовать вдоль полилинии. Участки гарантированно не перекрываются и не обязательно охватывают весь маршрут. При отсутствии изменения стиля дороги клиент должен применить к маршруту значение по умолчанию. |
ДорогаРастяжка
Один участок дороги, который необходимо отрендерить.
Поля | |
---|---|
style | Необходимый. Применяемый стиль. |
offset_meters | Необходимый. Стиль следует применять между |
length_meters | Необходимый. Длина пути, к которому применяется стиль. |
Стиль
Стиль движения, указывающий скорость движения.
Перечисления | |
---|---|
STYLE_UNSPECIFIED | Стиль не выбран. |
SLOWER_TRAFFIC | Движение замедляется. |
TRAFFIC_JAM | Есть пробка. |
Путевая точка
Описывает промежуточные точки на маршруте для VehicleMatch
в SearchVehiclesResponse
. Эта концепция представлена как TripWaypoint
во всех других конечных точках.
Поля | |
---|---|
lat_lng | Местоположение этой путевой точки. |
eta | Расчетное время прибытия транспортного средства в эту точку маршрута. |
Тип маршрутной точки
Тип путевой точки.
Перечисления | |
---|---|
UNKNOWN_WAYPOINT_TYPE | Неизвестный или неуказанный тип путевой точки. |
PICKUP_WAYPOINT_TYPE | Путевые точки для подбора гонщиков или предметов. |
DROP_OFF_WAYPOINT_TYPE | Путевые точки для высадки гонщиков или предметов. |
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE | Путевые точки для промежуточных пунктов назначения в поездке с несколькими пунктами назначения. |