Fleet Engine Entities

Интерфейс Task

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

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

Интерфейс TaskInfo

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

Тип TaskInfo, используемый DeliveryVehicleStop.
extraDurationMillis
необязательно
Тип: number optional
Дополнительное время, необходимое для выполнения задачи, в миллисекундах.
id
необязательно
Тип: string optional
Идентификатор задачи.
targetTimeWindow
необязательно
Тип: 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 символа.
  • Нормализован по форме нормализации Юникода C.
  • Не может содержать следующие символы ASCII: '/', ':', '?', ',' или '#'.
estimatedArrivalTime
необязательно
Тип: Date optional
Расчетное время прибытия на остановку.
estimatedTaskCompletionTime
необязательно
Тип: Date optional
Расчетное время выполнения задачи.
latestVehicleLocationUpdate
необязательно
Тип: VehicleLocationUpdate optional
Информация о последнем обновлении местоположения.
plannedLocation
необязательно
Тип: LatLng optional
Место, где будет выполнена задача.
remainingDrivingDistanceMeters
необязательно
Тип: number optional
Общее оставшееся расстояние в метрах до интересующего VehicleStop.
remainingStopCount
необязательно
Тип: number optional
Указывает количество остановок, которые осталось сделать транспортному средству до остановки, связанной с задачей, включая ее саму. Например, если следующая остановка транспортного средства – это остановка задачи, значение будет равно 1.
routePolylinePoints
необязательно
Тип: Array<LatLng> optional
Список точек, которые при соединении образуют ломаную линию ожидаемого маршрута транспортного средства к месту выполнения этой задачи.
state
необязательно
Тип: string optional
Текущий статус выполнения задачи.
targetTimeWindow
необязательно
Тип: TimeWindow optional
Временной интервал, в течение которого задача должна быть выполнена.
taskOutcome
необязательно
Тип: string optional
Результат попытки выполнить задачу.
taskOutcomeTime
необязательно
Тип: Date optional
Время, когда поставщик установил результат задачи.

Интерфейс Trip

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

Сведения о поездке, возвращенные Fleet Engine.
name
Тип: string
Формат: providers/{provider_id}/trips/{trip_id}. Идентификатор trip_id должен быть уникальным.
passengerCount
Тип: number
Количество пассажиров в поездке (не включая водителя).
remainingWaypoints
Массив путевых точек, указывающих путь от текущего местоположения до точки высадки.
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
необязательно
Тип: LatLngLiteral optional
Место, где клиент вышел из автомобиля.
actualPickupLocation
необязательно
Тип: LatLngLiteral optional
Место, где клиент сел в автомобиль.
dropOffTime
необязательно
Тип: Date optional
Расчетное время высадки пассажиров или фактическое время, когда они были высажены.
latestVehicleLocationUpdate
необязательно
Тип: VehicleLocationUpdate optional
Информация о последнем обновлении местоположения.
pickupTime
необязательно
Тип: Date optional
Расчетное время, когда пассажиры будут забраны, или фактическое время, когда они были забраны.
plannedDropOffLocation
необязательно
Тип: LatLngLiteral optional
Место, где клиент хочет выйти.
plannedPickupLocation
необязательно
Тип: 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
необязательно
Тип: LatLngLiteral optional
Место, где заканчивается текущий сегмент маршрута.
latestVehicleLocationUpdate
необязательно
Тип: VehicleLocationUpdate optional
Последнее известное местоположение транспортного средства доставки.
remainingDurationMillis
необязательно
Тип: number optional
Оставшееся время в пути на текущем сегменте маршрута в миллисекундах.

Интерфейс DeliveryVehicleStop

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

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

Константы DeliveryVehicleStopState

константы google.maps.journeySharing.DeliveryVehicleStopState
библиотека "journeySharing"

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

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом DeliveryVehicleStopStateString.

const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing");
ARRIVED Вы прибыли на остановку. Предполагается, что когда транспортное средство направляется к следующей остановке, все предыдущие остановки уже пройдены.
ENROUTE Назначен и активно маршрутизирует.
NEW Создан, но не используется для маршрутизации.
UNSPECIFIED Неизвестно.

Интерфейс VehicleJourneySegment

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

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

Интерфейс VehicleLocationUpdate

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

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

Интерфейс VehicleWaypoint

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

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

Интерфейс Vehicle

интерфейс 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
необязательно
Тип: TripWaypoint optional
Путевая точка, в которой заканчивается текущий сегмент маршрута.
currentRouteSegmentVersion
необязательно
Тип: Date optional
Время, когда был задан текущий сегмент маршрута.
currentTrips
необязательно
Тип: Array<string> optional
Список идентификаторов рейсов, назначенных этому транспортному средству.
etaToFirstWaypoint
необязательно
Тип: Date optional
Расчетное время прибытия в первую точку, указанную в поле waypoints.
latestLocation
необязательно
Тип: VehicleLocationUpdate optional
Последнее известное местоположение транспортного средства.
maximumCapacity
необязательно
Тип: number optional
Общее количество пассажиров, которое может перевозить транспортное средство. Водитель не учитывается.
supportedTripTypes
необязательно
Тип: Array<TripType> optional
Типы поездок, поддерживаемые этим транспортным средством.
waypoints
необязательно
Тип: Array<TripWaypoint> optional
Оставшиеся путевые точки, назначенные этому транспортному средству.
waypointsVersion
необязательно
Тип: Date optional
Время последнего обновления поля путевых точек.

Константы VehicleNavigationStatus

константы google.maps.journeySharing.VehicleNavigationStatus
библиотека "journeySharing"

Текущий статус навигации для Vehicle.

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом VehicleNavigationStatusString.

const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing");
ARRIVED_AT_DESTINATION Транспортное средство находится примерно в 50 м от пункта назначения.
ENROUTE_TO_DESTINATION Пошаговая навигация доступна, и навигация в приложении Driver перешла в режим GUIDED_NAV.
NO_GUIDANCE Навигация в приложении Driver находится в режиме FREE_NAV.
OFF_ROUTE Транспортное средство отклонилось от предложенного маршрута.
UNKNOWN_NAVIGATION_STATUS Статус навигации не указан.

Константы VehicleState

константы google.maps.journeySharing.VehicleState
библиотека "journeySharing"

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

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом VehicleStateString.

const {VehicleState} = await google.maps.importLibrary("journeySharing");
OFFLINE Транспортное средство не принимает новые поездки.
ONLINE Транспортное средство принимает новые поездки.
UNKNOWN_VEHICLE_STATE Неизвестное состояние автомобиля.

Константы VehicleType

константы google.maps.journeySharing.VehicleType
библиотека "journeySharing"

Тип свойства Vehicle.

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом VehicleTypeString.

const {VehicleType} = await google.maps.importLibrary("journeySharing");
AUTO Автомобиль.
TAXI Любое транспортное средство, которое используется в качестве такси (обычно лицензированное или регулируемое).
TRUCK Транспортное средство с большим багажником.
TWO_WHEELER Мотоцикл, мопед или другое двухколесное транспортное средство.
UNKNOWN Неизвестный тип транспортного средства.

Константы TripType

константы google.maps.journeySharing.TripType
библиотека "journeySharing"

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

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом TripTypeString.

const {TripType} = await google.maps.importLibrary("journeySharing");
EXCLUSIVE Рейс выполняется только одним транспортным средством.
SHARED Поездка может быть совместной с другими пассажирами.
UNKNOWN_TRIP_TYPE Неизвестный тип поездки.

Интерфейс TripWaypoint

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

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

Константы WaypointType

константы google.maps.journeySharing.WaypointType
библиотека "journeySharing"

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

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом WaypointTypeString.

const {WaypointType} = await google.maps.importLibrary("journeySharing");
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
библиотека "journeySharing"

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

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом SpeedString.

const {Speed} = await google.maps.importLibrary("journeySharing");
NORMAL Нормальная скорость, замедление не обнаружено.
SLOW Обнаружено замедление движения, но пробка не образовалась.
TRAFFIC_JAM Обнаружена пробка.

Интерфейс SpeedReadingInterval

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

Индикатор плотности трафика на непрерывном сегменте пути. Интервал определяет начальную и конечную точки сегмента по их индексам.
endPolylinePointIndex
Тип: number
Индекс конечной точки интервала на маршруте (с точкой отсчета в нуле).
speed
Тип: Speed
Скорость трафика за этот интервал.
startPolylinePointIndex
Тип: number
Индекс начальной точки интервала на маршруте (отсчет начинается с нуля).