Package maps.fleetengine.v1

BatteryStatus

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

PowerSource

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

float

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

SpeedReadingInterval

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

string

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

RequestHeader

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

string

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

string

Обязательно. Уникальный идентификатор поездки. Действуют следующие ограничения:

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

Trip

Обязательно. Необходимо создать объект поездки.

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

• trip_type
• pickup_point

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

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

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

Промежуточные intermediate_destinations поддерживаются только EXCLUSIVE поездках.

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

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

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

RequestHeader

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

string

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

string

Обязательно. Уникальный идентификатор транспортного средства. Действуют следующие ограничения:

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

Vehicle

Обязательно. Создаваемая сущность «Транспортное средство». При создании транспортного средства необходимо заполнить следующие поля:

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

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

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

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

RequestHeader

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

string

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

RequestHeader

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

string

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

LocationPowerSaveMode

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

bool

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

bool

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

BatteryInfo

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

RequestHeader

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

string

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

TripView

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

Timestamp

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

Timestamp

Устарело: данные Trip.remaining_waypoints извлекаются всегда. Используйте remaining_waypoints_route_version для управления временем извлечения данных Trip.remaining_waypoints.traffic_to_waypoint и Trip.remaining_waypoints.path_to_waypoint .

PolylineFormatType

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

Timestamp

Указывает минимальную временную метку (исключая её), для которой извлекается Trip.current_route_segment_traffic . Если данные о дорожном движении не изменились с момента получения этой временной метки, поле current_route_segment_traffic в ответе не задаётся. Если минимальное значение не указано, данные о дорожном движении извлекаются всегда. Обратите внимание, что данные о дорожном движении доступны только для клиентов сервиса «Поездки и доставка по запросу».

Timestamp

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

RequestHeader

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

string

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

Timestamp

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

Timestamp

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

string

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

string

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

• "ABC 1234" -> "4"
• "АБ 123 CD" -> "3"
• "ABCDEF" -> "-1"

RequestHeader

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

string

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

int32

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

string

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

Int32Value

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

TripType

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

Duration

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

Category

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

string

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

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

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

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

string

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

string

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

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

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

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

VehicleState

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

bool

Возвращайте только те транспортные средства, с которыми вы совершали текущую поездку(и).

string

Необязательно. Фильтрующий запрос, применяемый при выводе списка транспортных средств. Примеры синтаксиса фильтра см. на сайте http://aip.dev/160 .

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

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

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

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

Viewport

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

Vehicle

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

string

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

int64

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

string

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

string

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

BillingPlatformIdentifier

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

string

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

SolutionType

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

string

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

string

Обязательно. Код региона CLDR, откуда исходит запрос. Пример значения поля: US .

string

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

string

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

string

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

SdkType

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

string

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

string

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

Platform

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

string

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

int32

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

string

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

RequestHeader

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

string

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

string

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

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

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

int32

Если не установлено, сервер сам решает, сколько результатов возвращать.

string

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

Duration

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

Trip

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

string

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

RequestHeader

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

string

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

TerminalLocation

Обязательно. Место посадки, рядом с которым нужно искать.

TerminalLocation

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

int32

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

int32

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

int32

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

TripType

Обязательно. Указывает тип предполагаемой поездки. Должен быть указан только один тип. Значение UNKNOWN_TRIP_TYPE не допускается. Ограничивает поиск только теми транспортными средствами, которые поддерживают этот тип поездки.

Duration

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

VehicleType

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

VehicleAttribute

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

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

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

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

VehicleAttributeList

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

VehicleAttributeList

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

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

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

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

VehicleMatchOrder

Обязательно. Указывает желаемый критерий сортировки результатов.

bool

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

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

string

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

CurrentTripsPresent

Указывает, подходят ли для поиска транспортные средства с активными поездками. Значение должно быть отличным от CURRENT_TRIPS_PRESENT_UNSPECIFIED если trip_type включает SHARED .

string

Необязательно. Фильтрующий запрос, применяемый при поиске транспортных средств. Примеры синтаксиса фильтра см. на сайте http://aip.dev/160 .

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

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

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

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

VehicleMatch

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

int32

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

int32

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

Speed

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

LatLng

Обязательно. Указывает фактическое местоположение.

Timestamp

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

Timestamp

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

LatLng

Обозначает точные LatLng широты и долготы путевой точки. В качестве входных данных необходимо указать либо point , либо place . Если указаны оба, для маршрутизации будет использоваться point , а для метаданных — place . Если в качестве входных данных указано только place , point будет рассчитана на основе place и включена в выходные данные.

string

Имя ресурса места, представляющего это местоположение. Формат: places/{place_id} . В качестве входных данных необходимо указать либо point , либо place . Если указаны оба, point будет использоваться для маршрутизации, а place — для метаданных. place включается в выходные данные только в том случае, если оно было включено во входные данные, то есть поиск place по LatLng не выполняется.

Это экспериментальная функция.

PointSource

Только вывод. Источник point поля.

TerminalPointId

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

string

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

string

Устарело.

WaypointType

Устаревшее: Vehicle.waypoint будет иметь эти данные.

string

Устарело.

string

Устарело.

string

Устарело.

VisualTrafficReportPolylineRendering

Ломаная линия, отображающая скорость дорожного движения во всех регионах на одном участке маршрута клиента.

string

Только вывод. В формате "Providers/{Provider}/Trips/{Trip}"

string

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

TripStatus

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

TripType

Тип поездки.

TerminalLocation

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

StopLocation

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

StopLocation

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

Timestamp

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

TerminalLocation

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

Timestamp

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

int32

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

StopLocation

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

StopLocation

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

TerminalLocation

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

StopLocation

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

Timestamp

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

TripWaypoint

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

TripWaypoint

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

LatLng

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

string

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

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

Timestamp

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

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

ConsumableTrafficPolyline

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

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

Timestamp

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

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

TripWaypoint

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

Int32Value

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

Timestamp

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

Duration

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

Timestamp

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

Timestamp

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

int32

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

VehicleLocation

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

bool

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

TripView

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

TripAttribute

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

string

Ключ атрибута. Ключи могут не содержать персонажа толстой кишки (:).

string

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

bool

Логическое значение типичного атрибута.

double

Двойное значение атрибута.

TerminalLocation

Местоположение этой точки маршрута.

string

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

WaypointType

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

LatLng

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

string

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

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

ConsumableTrafficPolyline

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

Int32Value

Расстояние от предыдущей точки маршрута до текущей. Если это первая точка маршрута, расстояние определяется от текущего местоположения транспортного средства до этой точки.

Timestamp

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

Duration

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

RequestHeader

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

string

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

Trip

Требуется Поездка, связанная с обновлением.

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

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

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

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

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

FieldMask

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

RequestHeader

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

string

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

VehicleAttribute

Требуется Атрибуты транспортного средства для обновления. Не упорядоченные атрибуты не изменяются и не удаляются.

VehicleAttribute

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

RequestHeader

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

string

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

Vehicle

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

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

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

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

FieldMask

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

string

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

VehicleState

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

TripType

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

string

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

VehicleLocation

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

VehicleLocation

Только вход. Места, где этот автомобиль был в прошлом, о которых еще не сообщалось в двигатель флота. Это используется в UpdateVehicleRequest для записи местоположений, которые ранее не могли быть отправлены на сервер. Как правило, это происходит, когда автомобиль не имеет подключения к Интернету.

int32

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

VehicleAttribute

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

VehicleType

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

LicensePlate

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

TerminalLocation

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

string

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

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

TrafficPolylineData

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

Timestamp

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

TripWaypoint

Путь, где заканчивается current_route_segment . Это может быть предоставлено драйверами на вызовах UpdateVehicle или в качестве полной путевой точки, путевой LatLng , либо в качестве последнего LatLng current_route_segment . Двигатель флота будет сделан изо всех сил, чтобы интерполировать в реальную путевую точку, если он не будет полностью указан. Это поле игнорируется в вызовах UpdateVehicle , если также не указана current_route_segment .

Int32Value

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

Timestamp

ETA к первой записи в поле waypoints . Значение не определено, если поле waypoints пустое или поле Vehicle.current_route_segment пусто.

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

Int32Value

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

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

TripWaypoint

Оставшиеся путевые точки, назначенные этому транспортному средству.

Timestamp

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

bool

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

NavigationStatus

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

DeviceSettings

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

Category

Категория типа автомобиля

string

Ключ атрибута. Ключи могут не содержать персонажа толстой кишки (:).

string

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

string

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

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

bool

Логическое значение типичного атрибута.

double

Двойное значение атрибута.

VehicleAttribute

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

LatLng

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

DoubleValue

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

DoubleValue

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

Int32Value

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

DoubleValue

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

DoubleValue

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

DoubleValue

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

DoubleValue

Установите: используйте altitude_accuracy .

DoubleValue

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

Int32Value

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

DoubleValue

Скорость транспортного средства в метрах/секунду

DoubleValue

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

Timestamp

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

Timestamp

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

LocationSensor

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

BoolValue

Постановлено ли location на дорогу.

BoolValue

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

Int32Value

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

Int32Value

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

LatLng

Расположение необработанного транспортного средства (необработанное дорожным сноштом).

Timestamp

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

LocationSensor

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

DoubleValue

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

LatLng

Расположение от Android Fused Provider.

Timestamp

Обновление временной метки flp_location

DoubleValue

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

Int32Value

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

LatLng

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

Timestamp

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

LocationSensor

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

DoubleValue

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

bool

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

Vehicle

Требуется Автомобиль, который соответствует запросу.

Timestamp

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

Int32Value

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

Int32Value

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

Timestamp

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

Int32Value

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

TripType

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

Waypoint

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

VehicleMatchType

Тип матча автомобиля.

VehicleMatchOrder

Заказ запрошен для сортировки матчей транспортных средств. Эквивалентно ordered_by .

VehicleMatchOrder

Заказ запрошен для сортировки матчей транспортных средств. Эквивалентно requested_ordered_by .by.

RoadStretch

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

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

Style

Требуется Стиль для применения.

int32

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

int32

Требуется Длина пути, где применить стиль.

LatLng

Местоположение этой точки маршрута.

Timestamp

Предполагаемое время, когда транспортное средство поступит на эту путевую точку.