Fleet Engine Entities

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

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
Идентификатор транспортного средства, выполняющего эту задачу.

Интерфейс TaskInfo

google.maps.journeySharing . TaskInfo

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

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

Интерфейс 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

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

name
Тип: string
В формате «providers/{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
Место, откуда клиент укажет, что его заберут.

Интерфейс DeliveryVehicle

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

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

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

Константы 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

Тип сегмента VehicleJourney

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

Интерфейс 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

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

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

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

attributes
Тип: Object <string, *>
Пользовательские атрибуты транспортного средства.
name
Тип: string
В формате «providers/{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

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

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

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

Константы VehicleState

google.maps.journeySharing . VehicleState

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

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

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

Константы VehicleType

google.maps.journeySharing . VehicleType

Тип Vehicle .

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

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

Константы 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

Тип 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

Типы точек маршрута, поддерживаемые 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

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

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

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

google.maps.journeySharing . Speed

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

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

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

Интерфейс SpeedReadingInterval

google.maps.journeySharing . SpeedReadingInterval

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

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