Fleet Engine Entities

Интерфейс задачи

google.maps.journeySharing . Task Интерфейс google.maps.journeySharing . Task

Подробности задачи, возвращенные Fleet Engine.

attributes
Тип: Object <string, *>
Атрибуты, назначенные задаче.
name
Тип: string
Имя задачи в формате «providers/{provider_id}/tasks/{task_id}». Task_id должен быть уникальным идентификатором, а не идентификатором отслеживания. Чтобы сохранить идентификатор отслеживания отправления, используйте поле Tracking_id. Несколько задач могут иметь один и тот же идентификатор отслеживания.
remainingVehicleJourneySegments
Информация о сегментах, которые осталось заполнить для этой задачи.
status
Тип: string
Текущее состояние выполнения задачи.
type
Тип: string
Тип задачи; например, перерыв или пересылка.
estimatedCompletionTime optional
Тип: Date optional
Временная метка предполагаемого времени завершения задачи.
latestVehicleLocationUpdate optional
Тип: VehicleLocationUpdate optional
Информация, относящаяся к последнему обновлению местоположения.
outcome optional
Тип: string optional
Результат выполнения задачи.
outcomeLocation optional
Тип: LatLngLiteral optional
Место, где была выполнена задача (от провайдера).
outcomeLocationSource optional
Тип: string optional
Установщик местоположения результата задачи («PROVIDER» или «LAST_VEHICLE_LOCATION»).
outcomeTime optional
Тип: Date optional
Временная метка, когда был установлен результат задачи (от поставщика).
plannedLocation optional
Тип: LatLngLiteral optional
Место, где должно быть выполнено задание.
targetTimeWindow optional
Тип: TimeWindow optional
Временной интервал, в течение которого задача должна быть выполнена.
trackingId optional
Тип: string optional
Идентификатор отслеживания отправления.
vehicleId optional
Тип: string optional
Идентификатор транспортного средства, выполняющего эту задачу.

Интерфейс таскинформации

google.maps.journeySharing . TaskInfo Интерфейс google.maps.journeySharing . TaskInfo

Тип TaskInfo, используемый DeliveryVehicleStop .

extraDurationMillis optional
Тип: number optional
Дополнительное время, необходимое для выполнения задачи, в миллисекундах.
id optional
Тип: string optional
Идентификатор задачи.
targetTimeWindow optional
Тип: TimeWindow optional
Временной интервал, в течение которого задача должна быть выполнена.

Интерфейс ТаскТреккингИнфо

google.maps.journeySharing . TaskTrackingInfo Интерфейс google.maps.journeySharing . TaskTrackingInfo

Подробности информационного объекта отслеживания задач, возвращаемые Fleet Engine.

attributes
Тип: Object <string, *>
Атрибуты, назначенные задаче.
name
Тип: string
Имя в формате "providers/{provider_id}/taskTrackingInfo/{tracking_id}", где tracking_id представляет собой идентификатор отслеживания.
trackingId
Тип: string
Идентификатор отслеживания задачи.
  • Должна быть допустимой строкой Unicode.
  • Ограничена максимальной длиной в 64 символа.
  • Нормализовано в соответствии с формой нормализации Unicode C.
  • Не может содержать следующие символы ASCII: «/», «:», «?», «,» или «#».
estimatedArrivalTime optional
Тип: Date optional
Расчетное время прибытия к месту остановки.
estimatedTaskCompletionTime optional
Тип: Date optional
Предполагаемое время завершения задачи.
latestVehicleLocationUpdate optional
Тип: VehicleLocationUpdate optional
Информация, относящаяся к последнему обновлению местоположения.
plannedLocation optional
Тип: LatLng optional
Место, где будет выполнено задание.
remainingDrivingDistanceMeters optional
Тип: number optional
Общее оставшееся расстояние в метрах до интересующей VehicleStop .
remainingStopCount optional
Тип: number optional
Указывает количество остановок, оставшихся у транспортного средства до достижения заданной остановки, включая заданную остановку. Например, если следующая остановка транспортного средства — это остановка задания, значение будет равно 1.
routePolylinePoints optional
Тип: Array < LatLng > optional
Список точек, которые при соединении образуют ломаную линию предполагаемого маршрута автомобиля к месту выполнения этой задачи.
state optional
Тип: string optional
Текущее состояние выполнения Задачи.
targetTimeWindow optional
Тип: TimeWindow optional
Временной интервал, в течение которого задача должна быть выполнена.
taskOutcome optional
Тип: string optional
Результат попытки выполнить Задачу.
taskOutcomeTime optional
Тип: Date optional
Время, когда провайдер установил результат Задания.

Интерфейс поездки

google.maps.journeySharing . Trip Интерфейс google.maps.journeySharing . Trip

Подробности о поездке, возвращенные Fleet Engine.

name
Тип: string
В формате «провайдеры/{provider_id}/trips/{trip_id}». trip_id должен быть уникальным идентификатором.
passengerCount
Тип: number
Количество пассажиров в этой поездке; не включает драйвер.
remainingWaypoints
Тип: Array < VehicleWaypoint >
Массив путевых точек, указывающий путь от текущего местоположения до точки высадки.
status
Тип: string
Текущий статус поездки. Возможные значения: UNKNOWN_TRIP_STATUS, NEW, ENROUTE_TO_PICKUP, ARRIVED_AT_PICKUP, ARRIVED_AT_INTERMEDIATE_DESTINATION, ENROUTE_TO_INTERMEDIATE_DESTINATION, ENROUTE_TO_DROPOFF, COMPLETE или CANCELED.
type
Тип: string
Тип поездки. Возможные значения: UNKNOWN_TRIP_TYPE, SHARED или EXCLUSIVE.
vehicleId
Тип: string
Идентификатор транспортного средства, совершающего эту поездку.
actualDropOffLocation optional
Тип: LatLngLiteral optional
Место, куда высадили клиента.
actualPickupLocation optional
Тип: LatLngLiteral optional
Место, где забрали клиента.
dropOffTime optional
Тип: Date optional
Предполагаемое будущее время, когда пассажиры будут высажены, или фактическое время, когда они были высажены.
latestVehicleLocationUpdate optional
Тип: VehicleLocationUpdate optional
Информация, относящаяся к последнему обновлению местоположения.
pickupTime optional
Тип: Date optional
Предполагаемое будущее время, когда пассажиров заберут, или фактическое время, когда их заберут.
plannedDropOffLocation optional
Тип: LatLngLiteral optional
Место, где клиент указывает, что его высадят.
plannedPickupLocation optional
Тип: LatLngLiteral optional
Место, где клиент укажет, что его заберут.

ДоставкаАвтомобильный интерфейс

google.maps.journeySharing . DeliveryVehicle интерфейс

Подробная информация о транспортном средстве доставки, возвращенном Fleet Engine.

attributes
Тип: Object <string, string optional >
Атрибуты транспортного средства индивидуальной доставки.
name
Тип: string
В формате "providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}". Delivery_vehicle_id должен быть уникальным идентификатором.
navigationStatus
Тип: string
Текущий навигационный статус автомобиля.
remainingDistanceMeters
Тип: number
Оставшееся расстояние на текущем участке маршрута в метрах.
remainingVehicleJourneySegments
Сегменты поездки, назначенные этому транспортному средству доставки, начиная с последнего зарегистрированного местоположения транспортного средства. Оно заполняется только в том случае, если объект данных DeliveryVehicle предоставляется через FleetEngineDeliveryVehicleLocationProvider .
currentRouteSegmentEndPoint optional
Тип: LatLngLiteral optional
Место, где заканчивается текущий сегмент маршрута.
latestVehicleLocationUpdate optional
Тип: VehicleLocationUpdate optional
Последнее сообщенное местонахождение транспортного средства.
remainingDurationMillis optional
Тип: number optional
Оставшаяся продолжительность поездки на текущем участке маршрута в миллисекундах.

Интерфейс DeliveryVehicleStop

google.maps.journeySharing . DeliveryVehicleStop Интерфейс google.maps.journeySharing . DeliveryVehicleStop

ДоставкаТранспортное средствоТип остановки

tasks
Тип: Array < TaskInfo >
Перечень Заданий, которые необходимо выполнить на этой остановке.
  • id : идентификатор задачи.
  • extraDurationMillis : дополнительное время, необходимое для выполнения задачи, в миллисекундах.
plannedLocation optional
Тип: LatLngLiteral optional
Расположение остановки.
state optional
Тип: DeliveryVehicleStopState optional
Состояние остановки.

Константы DeliveryVehicleStopState

google.maps.journeySharing . DeliveryVehicleStopState Константы google.maps.journeySharing . DeliveryVehicleStopState

Текущее состояние DeliveryVehicleStop .

Доступ осуществляется путем вызова const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing") . См. раздел Библиотеки в Maps JavaScript API .

ARRIVED Прибыл на остановку. Предполагается, что когда транспортное средство направляется к следующей остановке, все предыдущие остановки завершены.
ENROUTE Назначен и активно маршрутизируется.
NEW Создан, но не активно маршрутизируется.
UNSPECIFIED Неизвестный.

Интерфейс VehicleJourneySegment

google.maps.journeySharing . VehicleJourneySegment Интерфейс google.maps.journeySharing . VehicleJourneySegment

Тип сегмента транспортного средстваПутешествие

drivingDistanceMeters optional
Тип: number optional
Расстояние проезда от предыдущей остановки до этой остановки в метрах.
drivingDurationMillis optional
Тип: number optional
Время в пути от предыдущей остановки до этой остановки в миллисекундах.
path optional
Тип: Array < LatLngLiteral > optional
Путь от предыдущей остановки (или текущего местоположения ТС, если эта остановка первая в списке остановок) до этой остановки.
stop optional
Тип: DeliveryVehicleStop optional
Информация об остановке.

Интерфейс обновления местоположения транспортного средства

google.maps.journeySharing . VehicleLocationUpdate Интерфейс google.maps.journeySharing . VehicleLocationUpdate

Тип обновления местоположения транспортного средства

heading optional
Тип: number optional
Заголовок обновления. 0 соответствует северу, 180 — югу.
location optional
Тип: LatLngLiteral | LatLng optional
Местоположение обновления.
speedKilometersPerHour optional
Тип: number optional
Скорость в километрах в час.
time optional
Тип: Date optional
Время получения этого обновления от автомобиля.

Интерфейс VehicleWaypoint

google.maps.journeySharing . VehicleWaypoint Интерфейс google.maps.journeySharing . VehicleWaypoint

Тип путевой точки транспортного средства.

distanceMeters optional
Тип: number optional
Расстояние пути между предыдущей путевой точкой (или текущим местоположением автомобиля, если эта путевая точка первая в списке путевых точек) до этой путевой точки в метрах.
durationMillis optional
Тип: number optional
Время в пути между предыдущей путевой точкой (или текущим местоположением автомобиля, если эта путевая точка первая в списке путевых точек) до этой путевой точки в миллисекундах.
location optional
Тип: LatLngLiteral optional
Местоположение путевой точки.
path optional
Тип: Array < LatLngLiteral > optional
Путь от предыдущей путевой точки (или текущего местоположения автомобиля, если эта путевая точка первая в списке путевых точек) до этой путевой точки.
speedReadingIntervals optional
Тип: Array < SpeedReadingInterval > optional
Список скоростей движения на пути от предыдущей путевой точки (или местоположения автомобиля) до текущей путевой точки. Каждый интервал в списке описывает трафик на непрерывном сегменте пути; интервал определяет начальную и конечную точки сегмента через их индексы. Дополнительные сведения см. в определении SpeedReadingInterval .

Интерфейс автомобиля

google.maps.journeySharing . Vehicle Интерфейс google.maps.journeySharing . Vehicle

Подробная информация об автомобиле, возвращенном Fleet Engine.

attributes
Тип: Object <string, *>
Пользовательские атрибуты автомобиля.
name
Тип: string
В формате «провайдеры/{provider_id}/vehicles/{vehicle_id}». Vehicle_id должен быть уникальным идентификатором.
navigationStatus
Текущий навигационный статус автомобиля.
remainingDistanceMeters
Тип: number
Оставшееся расстояние на текущем участке маршрута в метрах.
vehicleState
Тип: VehicleState
Состояние автомобиля.
vehicleType
Тип: Тип VehicleType
Тип этого автомобиля.
currentRouteSegmentEndPoint optional
Тип: TripWaypoint optional
Маршрутная точка, где заканчивается текущий сегмент маршрута.
currentRouteSegmentVersion optional
Тип: Date optional
Время установки текущего сегмента маршрута.
currentTrips optional
Тип: Array <string> optional
Список идентификаторов поездок, назначенных в данный момент этому транспортному средству.
etaToFirstWaypoint optional
Тип: Date optional
Расчетное время прибытия до первой записи в поле путевых точек.
latestLocation optional
Тип: VehicleLocationUpdate optional
Последнее сообщенное местонахождение автомобиля.
maximumCapacity optional
Тип: number optional
Общее количество пассажиров, которое может перевозить этот автомобиль. Драйвер не учитывается в этом значении.
supportedTripTypes optional
Тип: Array < TripType > optional
Типы поездок, поддерживаемые этим автомобилем.
waypoints optional
Тип: Array < TripWaypoint > optional
Остальные путевые точки назначены этому Транспортному средству.
waypointsVersion optional
Тип: Date optional
Последний раз поле путевых точек обновлялось.

Константы VehicleNavigationStatus

google.maps.journeySharing . VehicleNavigationStatus Константы google.maps.journeySharing . VehicleNavigationStatus

Текущий навигационный статус Vehicle .

Доступ осуществляется путем вызова const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing") . См. раздел Библиотеки в Maps JavaScript API .

ARRIVED_AT_DESTINATION Транспортное средство находится примерно в 50 метрах от места назначения.
ENROUTE_TO_DESTINATION Доступна пошаговая навигация, а навигация в приложении для водителей перешла в режим GUIDED_NAV.
NO_GUIDANCE Навигация в приложении «Драйвер» находится в режиме FREE_NAV.
OFF_ROUTE Транспортное средство вышло за пределы предложенного маршрута.
UNKNOWN_NAVIGATION_STATUS Неопределенный статус навигации.

Константы VehicleState

google.maps.journeySharing . VehicleState Константы google.maps.journeySharing . VehicleState

Текущее состояние Vehicle .

Доступ осуществляется путем вызова const {VehicleState} = await google.maps.importLibrary("journeySharing") . См. раздел Библиотеки в Maps JavaScript API .

OFFLINE Транспортное средство не принимает новые поездки.
ONLINE Транспортное средство принимает новые поездки.
UNKNOWN_VEHICLE_STATE Неизвестное состояние автомобиля.

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

google.maps.journeySharing . VehicleType Константы google.maps.journeySharing . VehicleType

Тип Vehicle .

Доступ осуществляется путем вызова const {VehicleType} = await google.maps.importLibrary("journeySharing") . См. раздел Библиотеки в Maps JavaScript API .

AUTO Автомобиль.
TAXI Любое транспортное средство, выполняющее функции такси (обычно лицензированное или регулируемое).
TRUCK Автомобиль с большим багажником.
TWO_WHEELER Мотоцикл, мопед или другое двухколесное транспортное средство.
UNKNOWN Неизвестный тип транспортного средства.

Константы типа поездки

google.maps.journeySharing . TripType Константы google.maps.journeySharing . TripType

Типы поездок, поддерживаемые Vehicle .

Доступ осуществляется путем вызова const {TripType} = await google.maps.importLibrary("journeySharing") . См. раздел Библиотеки в Maps JavaScript API .

EXCLUSIVE Поездка эксклюзивна на автомобиле.
SHARED В поездке может использоваться совместное транспортное средство с другими поездками.
UNKNOWN_TRIP_TYPE Неизвестный тип поездки.

Интерфейс TripWaypoint

google.maps.journeySharing . TripWaypoint Интерфейс google.maps.journeySharing . TripWaypoint

Тип TripWaypoint.

distanceMeters optional
Тип: number optional
Расстояние пути между предыдущей путевой точкой (или текущим местоположением автомобиля, если эта путевая точка первая в списке путевых точек) до этой путевой точки в метрах.
durationMillis optional
Тип: number optional
Время в пути между предыдущей путевой точкой (или текущим местоположением автомобиля, если эта путевая точка первая в списке путевых точек) до этой путевой точки в миллисекундах.
location optional
Тип: LatLng optional
Местоположение путевой точки.
path optional
Тип: Array < LatLng > optional
Путь от предыдущей остановки (или текущего местоположения ТС, если эта остановка первая в списке остановок) до этой остановки.
speedReadingIntervals optional
Тип: Array < SpeedReadingInterval > optional
Список скоростей движения на пути от предыдущей путевой точки (или местоположения автомобиля) до текущей путевой точки. Каждый интервал в списке описывает трафик на непрерывном сегменте пути; интервал определяет начальную и конечную точки сегмента через их индексы. Дополнительные сведения см. в определении SpeedReadingInterval .
tripId optional
Тип: string optional
Поездка, связанная с этой путевой точкой.
waypointType optional
Тип: WaypointType optional
Роль, которую эта путевая точка играет в этой поездке, например, посадка или высадка.

Константы WaypointType

google.maps.journeySharing . WaypointType Константы google.maps.journeySharing . WaypointType

Типы маршрутных точек, поддерживаемые Vehicle .

Доступ осуществляется путем вызова const {WaypointType} = await google.maps.importLibrary("journeySharing") . См. раздел Библиотеки в Maps JavaScript API .

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

Интерфейс TimeWindow

google.maps.journeySharing . TimeWindow Интерфейс google.maps.journeySharing . TimeWindow

Временной диапазон.

endTime
Тип: Date
Время окончания временного окна (включительно).
startTime
Тип: Date
Время начала временного окна (включительно).

Константы скорости

google.maps.journeySharing . Speed Константы google.maps.journeySharing . Speed

Классификация скорости полилинии на основе данных о трафике.

Доступ осуществляется путем вызова const {Speed} = await google.maps.importLibrary("journeySharing") . См. раздел Библиотеки в Maps JavaScript API .

NORMAL Скорость нормальная, замедлений не обнаружено.
SLOW Замедление зафиксировано, но пробки не образовалось.
TRAFFIC_JAM Обнаружена пробка.

Интерфейс SpeedReadingInterval

google.maps.journeySharing . SpeedReadingInterval Интерфейс google.maps.journeySharing . SpeedReadingInterval

Индикатор плотности трафика на непрерывном участке пути. Интервал определяет начальную и конечную точки сегмента через их индексы.

endPolylinePointIndex
Тип: number
Отсчитываемый от нуля индекс конечной точки интервала пути.
speed
Тип: Speed
Скорость движения в этом интервале.
startPolylinePointIndex
Тип: number
Отсчитываемый от нуля индекс начальной точки интервала пути.