Индекс
-
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 | Необходимый. Поездка, связанная с обновлением. Следующие поля поддерживаются двигателем флота. Не обновляйте их, используя Trip.update.
Когда вы обновляете Когда вы указываете Чтобы избежать условий гонки для поездок с несколькими направлениями, вы должны предоставить |
update_mask | Необходимый. Полевая маска, указывающая, какие поля в поездке в обновление. |
UpdateVehiCLeatTributesRequest
UpdateVehicleAttributes
Сообщение запроса.
Поля | |
---|---|
header | Стандартный заголовок запроса Fleet Engine. |
name | Необходимый. Должен быть в |
attributes[] | Необходимый. Атрибуты транспортного средства для обновления. Не упорядоченные атрибуты не изменяются и не удаляются. |
UpdateVehiCLeatTributesResponse
UpdateVehicleAttributes
Ответное сообщение.
Поля | |
---|---|
attributes[] | Необходимый. Обновленный полный список атрибутов автомобиля, включая новые, измененные и нетронутые атрибуты. |
UpdateVehicLeQuest
`Сообщение запроса updatewarehicle.
Поля | |
---|---|
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 | Полилина, указывающая маршрут, который приложение драйвера намеревается перейти к следующей путевой точке. Этот список также возвращается в Примечание. Это поле предназначено только для использования драйвером SDK. Декодирование еще не поддерживается. |
current_route_segment_traffic | Только ввод. Fleet Engine использует эту информацию для улучшения обмена путешествиями. Примечание. Это поле предназначено только для использования драйвером SDK. |
current_route_segment_version | Только вывод. Время, когда было установлено |
current_route_segment_end_point | Путь, где заканчивается |
remaining_distance_meters | Остальное расстояние вождения для |
eta_to_first_waypoint | ETA к первой записи в поле При обновлении транспортного средства |
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 к точке пикапа, указанной в запросе. Пустое значение указывает на сбой при расчете ETA для транспортного средства. Если |
vehicle_pickup_distance_meters | Расстояние от текущего местоположения транспортного средства до точки сбора, указанного в запросе, в том числе любых промежуточных точек пикапа или высадки для существующих поездок. Это расстояние включает в себя рассчитанное расстояние вождения (маршрута), плюс прямое расстояние между конечной точкой навигации и запрошенной точкой сбора. (Расстояние между конечной точкой навигации и запрашиваемой точкой подбора, как правило, мало.) Пустое значение указывает на ошибку при расчете расстояния. |
vehicle_pickup_straight_line_distance_meters | Необходимый. Прямое расстояние между транспортным средством и точкой набора, указанное в запросе. |
vehicle_dropoff_eta | Полное транспортное средство за рулем ETA до точки сброса, указанная в запросе. ETA включает в себя остановку в любых путевых точках до того, как |
vehicle_pickup_to_dropoff_distance_meters | Расстояние проезда транспортного средства (в метрах) от точки сбора до точки сброса, указанной в запросе. Расстояние находится только между двумя точками и не включает в себя местоположение транспортного средства или любые другие точки, которые должны быть посещены до того, как транспортное средство посетит либо точку сбора или точку высадки. Значение будет заполнено только тогда, когда в запросе указан в запросе |
trip_type | Необходимый. Тип поезда запроса, который использовался для расчета ETA в точку питания. |
vehicle_trips_waypoints[] | Упорядоченный список путевых точек, используемых для расчета ETA. Список включает в себя местоположение транспортного средства, точки сбора активных поездок для транспортного средства и точки сбора, представленные в запросе. Пустой список указывает на сбой при расчете ETA для транспортного средства. |
vehicle_match_type | Тип матча автомобиля. |
requested_ordered_by | Заказ запрошен для сортировки матчей транспортных средств. |
ordered_by | Фактический порядок, который использовался для этого автомобиля. Обычно это соответствует поле «order_by» из запроса; Однако в определенных обстоятельствах, таких как внутренняя ошибка сервера, можно использовать другой метод (например, |
Efacelematchtype
Тип автомобиля соответствует.
Перечисления | |
---|---|
UNKNOWN | Неизвестный тип совпадения автомобиля |
EXCLUSIVE | В настоящее время транспортное средство не назначено поездка, и он может перейти к точке пикапа. |
BACK_TO_BACK | Транспортное средство в настоящее время назначено в поездку, но может перейти к точке пикапа после завершения в процессе поездки. Расчеты ETA и расстояния принимают во внимание существующую поездку. |
CARPOOL | Транспортное средство имеет достаточную мощность для общей поездки. |
CARPOOL_BACK_TO_BACK | Автомобиль завершит свою текущую активную поездку, прежде чем перейти к точке пикапа. Расчеты ETA и расстояния принимают во внимание существующую поездку. |
Автомобиль
Состояние Vehicle
.
Перечисления | |
---|---|
UNKNOWN_VEHICLE_STATE | По умолчанию, используется для неуточненных или непризнанных состояний транспортного средства. |
OFFLINE | Автомобиль не принимает новые поездки. ПРИМЕЧАНИЕ. Транспортное средство может продолжать работать в этом состоянии при завершении поездок, назначенного ему. |
ONLINE | Автомобиль принимает новые поездки. |
VisualTrafficReportpolylinerendering
Описывает, как клиенты должны окрасить одну часть полилины вдоль маршрута.
Поля | |
---|---|
road_stretch[] | Необязательный. Дорожные растяжки, которые должны быть отображены вдоль полилины. Растяжки гарантированно не перекрываются и не обязательно охватывают весь маршрут. В отсутствие дороги в стиле клиент должен применить по умолчанию маршрут. |
Roadstrech
Один дорожный отрез, который должен быть отображен.
Поля | |
---|---|
style | Необходимый. Стиль для применения. |
offset_meters | Необходимый. Стиль должен быть применен между |
length_meters | Необходимый. Длина пути, где применить стиль. |
Стиль
Стиль трафика, указывающий на скорость трафика.
Перечисления | |
---|---|
STYLE_UNSPECIFIED | Нет стиля не выбрано. |
SLOWER_TRAFFIC | Движение замедляется. |
TRAFFIC_JAM | Есть пробка. |
Путевая точка
Описывает промежуточные точки вдоль маршрута для VehicleMatch
в SearchVehiclesResponse
. Эта концепция представлена как TripWaypoint
во всех других конечных точках.
Поля | |
---|---|
lat_lng | Расположение этой путевой точки. |
eta | Предполагаемое время, когда транспортное средство поступит на эту путевую точку. |
WayPointType
Тип путевой точки.
Перечисления | |
---|---|
UNKNOWN_WAYPOINT_TYPE | Неизвестный или неопределенный тип путевой точки. |
PICKUP_WAYPOINT_TYPE | Путевые точки для подбора гонщиков или предметов. |
DROP_OFF_WAYPOINT_TYPE | Путевые точки для сброса гонщиков или предметов. |
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE | Путевые точки для промежуточных направлений в поездке с несколькими назначениями. |