Fleet Engine Entities

Interfaz Task

Interfaz de google.maps.journeySharing.Task

Los detalles de una tarea que muestra Fleet Engine.

attributes
Tipo:  Object<string, *>
Atributos asignados a la tarea.
name
Tipo:  string
El nombre de la tarea con el formato “providers/{provider_id}/tasks/{task_id}”. El task_id debe ser un identificador único y no un ID de seguimiento. Para almacenar un ID de seguimiento de un envío, utiliza el campo tracking_id. Varias tareas pueden tener el mismo id_seguimiento.
remainingVehicleJourneySegments
Información sobre los segmentos que faltan por completar para esta tarea.
status
Tipo:  string
El estado actual de la ejecución de la tarea.
type
Tipo:  string
Indica el tipo de tarea; por ejemplo, una pausa o un envío.
estimatedCompletionTime optional
Tipo:  Date optional
La marca de tiempo de la hora estimada de finalización de la tarea.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Información específica de la última actualización de ubicación.
outcome optional
Tipo:  string optional
El resultado de la tarea.
outcomeLocation optional
Tipo:  LatLngLiteral optional
Es la ubicación en la que se completó la tarea (del proveedor).
outcomeLocationSource optional
Tipo:  string optional
El método set de la ubicación del resultado de la tarea ("PROVIDER" o "LAST_VEHICLE_LOCATION").
outcomeTime optional
Tipo:  Date optional
La marca de tiempo del momento en que se configuró el resultado de la tarea (desde el proveedor).
plannedLocation optional
Tipo:  LatLngLiteral optional
Es la ubicación donde se debe completar la tarea.
targetTimeWindow optional
Tipo:  TimeWindow optional
Es el período durante el cual se debe completar la tarea.
trackingId optional
Tipo:  string optional
Es el ID de seguimiento del envío.
vehicleId optional
Tipo:  string optional
Es el ID del vehículo que realiza esta tarea.

Interfaz de TaskInfo

Interfaz de google.maps.journeySharing.TaskInfo

Tipo de TaskInfo, que usa DeliveryVehicleStop.

extraDurationMillis optional
Tipo:  number optional
El tiempo adicional que se tarda en realizar la tarea, en milisegundos.
id optional
Tipo:  string optional
El ID de la tarea.
targetTimeWindow optional
Tipo:  TimeWindow optional
Es el período durante el cual se debe completar la tarea.

TaskTrackingInfo.

Interfaz de google.maps.journeySharing.TaskTrackingInfo

Los detalles de un objeto de información de seguimiento de tareas que muestra Fleet Engine.

attributes
Tipo:  Object<string, *>
Atributos asignados a la tarea.
name
Tipo:  string
Es el nombre con el formato "providers/{provider_id}/taskTrackingInfo/{tracking_id}", donde tracking_id representa el ID de seguimiento.
trackingId
Tipo:  string
El ID de seguimiento de una Task.
  • Debe ser una string Unicode válida.
  • Tiene una longitud máxima de 64 caracteres.
  • Se normalizó según el Formulario de normalización C de Unicode.
  • No puede contener ninguno de los siguientes caracteres ASCII: “/”, “:”, “?”, “,” o '#'.
estimatedArrivalTime optional
Tipo:  Date optional
Es la hora estimada de llegada a la ubicación de la parada.
estimatedTaskCompletionTime optional
Tipo:  Date optional
Es la hora de finalización estimada de una tarea.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Información específica de la última actualización de ubicación.
plannedLocation optional
Tipo:  LatLng optional
Es la ubicación en la que se completará la tarea.
remainingDrivingDistanceMeters optional
Tipo:  number optional
La distancia total restante en metros al VehicleStop de interés.
remainingStopCount optional
Tipo:  number optional
Indica la cantidad de paradas que quedan en el vehículo hasta llegar a la parada de tareas, incluida la parada de tareas. Por ejemplo, si la siguiente parada del vehículo es la parada de tareas, el valor será 1.
routePolylinePoints optional
Tipo:  Array<LatLng> optional
Una lista de puntos que, cuando se conectan, forman una polilínea de la ruta esperada del vehículo hacia la ubicación de esta tarea.
state optional
Tipo:  string optional
El estado actual de la ejecución de la Task.
targetTimeWindow optional
Tipo:  TimeWindow optional
Es el período durante el cual se debe completar la tarea.
taskOutcome optional
Tipo:  string optional
El resultado de intentar ejecutar una Task.
taskOutcomeTime optional
Tipo:  Date optional
Es el momento en que el proveedor estableció el resultado de la tarea.

Trip

Interfaz de google.maps.journeySharing.Trip

Los detalles de un viaje devuelto por Fleet Engine.

name
Tipo:  string
Debe tener el formato "providers/{provider_id}/trips/{trip_id}". El trip_id debe ser un identificador único.
passengerCount
Tipo:  number
Cantidad de pasajeros de este viaje; no incluye al conductor
remainingWaypoints
Un array de puntos de referencia que indica la ruta desde la ubicación actual hasta el punto de destino.
status
Tipo:  string
Estado actual del viaje. Los valores posibles son UNKNOWN_TRIP_STATUS, NEW, ENROUTE_TO_PICKUP, ARRIVED_AT_PICKUP, ARRIVED_AT_INTERMEDIATE_DESTINATION, ENROUTE_TO_INTERMEDIATE_DESTINATION, ENROUTE_TO_DROPOFF, COMPLETE o CANCELED.
type
Tipo:  string
Es el tipo de viaje. Los valores posibles son UNKNOWN_TRIP_TYPE, SHARED o EXCLUSIVE.
vehicleId
Tipo:  string
Es el ID del vehículo que realiza este viaje.
actualDropOffLocation optional
Tipo:  LatLngLiteral optional
Ubicación en la que el cliente dejó el lugar.
actualPickupLocation optional
Tipo:  LatLngLiteral optional
Ubicación donde se recogieron al cliente.
dropOffTime optional
Tipo:  Date optional
La hora futura estimada en la que los pasajeros bajarán o la hora real en la que bajarán.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Información específica de la última actualización de ubicación.
pickupTime optional
Tipo:  Date optional
La hora futura estimada en la que se recogerán los pasajeros o la hora real en la que se recogerán.
plannedDropOffLocation optional
Tipo:  LatLngLiteral optional
Ubicación en la que el cliente indica que bajarán del vehículo.
plannedPickupLocation optional
Tipo:  LatLngLiteral optional
Es la ubicación en la que el cliente indica que lo retirarán.

Interfaz de DeliveryVehicle

Interfaz de google.maps.journeySharing.DeliveryVehicle

Los detalles de un vehículo de entrega devuelto por Fleet Engine.

attributes
Tipo:  Object<string, string optional>
Atributos de vehículos de entrega personalizados.
name
Tipo:  string
Debe tener el formato "providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}". Delivery_vehicle_id debe ser un identificador único.
navigationStatus
Tipo:  string
Indica el estado actual de la navegación del vehículo.
remainingDistanceMeters
Tipo:  number
La distancia de conducción restante en el tramo de ruta actual, en metros.
remainingVehicleJourneySegments
Los tramos de viaje asignados a este vehículo de reparto, comenzando por la ubicación más reciente del vehículo. Solo se propaga cuando el objeto de datos DeliveryVehicle se proporciona a través de FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
Tipo:  LatLngLiteral optional
La ubicación donde termina el tramo de ruta actual.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Es la última ubicación informada del vehículo de entrega.
remainingDurationMillis optional
Tipo:  number optional
La duración restante del viaje en el tramo de ruta actual, en milisegundos.

Interfaz de DeliveryVehicleStop

Interfaz de google.maps.journeySharing.DeliveryVehicleStop

Tipo de DeliveryVehicleStop

tasks
Tipo:  Array<TaskInfo>
Es la lista de tareas que se realizarán en esta parada.
  • id: Es el ID de la tarea.
  • extraDurationMillis: Es el tiempo adicional que se tarda en realizar la tarea, en milisegundos.
plannedLocation optional
Tipo:  LatLngLiteral optional
Es la ubicación de la parada.
state optional
Tipo:  DeliveryVehicleStopState optional
Es el estado de la parada.

Constantes DeliveryVehicleStopState.

Constantes google.maps.journeySharing.DeliveryVehicleStopState

El estado actual de un DeliveryVehicleStop.

Para acceder, llama a const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

ARRIVED Llegaste a la parada. Supone que, cuando el vehículo está dirigiendo a la siguiente parada, se completaron todas las paradas anteriores.
ENROUTE Asignado y enrutando activamente.
NEW Se creó, pero no se enrutó de forma activa.
UNSPECIFIED Desconocido.

VehicleJourneySegment

Interfaz de google.maps.journeySharing.VehicleJourneySegment

Tipo de segmento de recorrido del vehículo

drivingDistanceMeters optional
Tipo:  number optional
La distancia de viaje desde la parada anterior hasta esta parada en metros.
drivingDurationMillis optional
Tipo:  number optional
Indica la duración de viaje desde la parada anterior de esta parada, en milisegundos.
path optional
Tipo:  Array<LatLngLiteral> optional
Indica la ruta desde la parada anterior (o la ubicación actual del vehículo, si esta es la primera de la lista de paradas) hasta esta parada.
stop optional
Tipo:  DeliveryVehicleStop optional
Información sobre la parada.

Interfaz de VehicleLocationUpdate

Interfaz de google.maps.journeySharing.VehicleLocationUpdate

Tipo de VehicleLocationUpdate

heading optional
Tipo:  number optional
El encabezado de la actualización. 0 corresponde al norte, 180 al sur.
location optional
Tipo:  LatLngLiteral|LatLng optional
Es la ubicación de la actualización.
speedKilometersPerHour optional
Tipo:  number optional
Es la velocidad en kilómetros por hora.
time optional
Tipo:  Date optional
Indica la hora a la que se recibió esta actualización del vehículo.

VehicleWaypoint

Interfaz de google.maps.journeySharing.VehicleWaypoint

Tipo de punto de referencia para vehículos.

distanceMeters optional
Tipo:  number optional
La distancia de la ruta entre el punto de referencia anterior (o la ubicación actual del vehículo, si es el primero de la lista de puntos de referencia) al punto de referencia en metros.
durationMillis optional
Tipo:  number optional
Tiempo de viaje entre el punto de referencia anterior (o la ubicación actual del vehículo, si es el primero de la lista de puntos de referencia) hasta este punto de referencia en milisegundos.
location optional
Tipo:  LatLngLiteral optional
La ubicación del punto de referencia.
path optional
Tipo:  Array<LatLngLiteral> optional
La ruta desde el punto de referencia anterior (o la ubicación actual del vehículo, si es el primero de la lista de puntos de referencia) hasta este punto de referencia.
speedReadingIntervals optional
Tipo:  Array<SpeedReadingInterval> optional
La lista de velocidades de tráfico a lo largo de la ruta desde el punto de referencia anterior (o la ubicación del vehículo) hasta el punto de referencia actual. Cada intervalo de la lista describe el tráfico de un segmento contiguo en la ruta; el intervalo define los puntos de inicio y finalización del tramo a través de sus índices. Para obtener más información, consulta la definición de SpeedReadingInterval.

Vehicle

Interfaz de google.maps.journeySharing.Vehicle

Los detalles de un vehículo devuelto por Fleet Engine.

attributes
Tipo:  Object<string, *>
Atributos personalizados del vehículo.
name
Tipo:  string
Debe tener el formato "providers/{provider_id}/vehicles/{vehicle_id}". El vehículo_id debe ser un identificador único.
navigationStatus
Indica el estado actual de la navegación del vehículo.
remainingDistanceMeters
Tipo:  number
La distancia de conducción restante en el tramo de ruta actual, en metros.
vehicleState
Tipo:  VehicleState
Es el estado del vehículo.
vehicleType
Tipo:  VehicleType
Es el tipo de este vehículo.
currentRouteSegmentEndPoint optional
Tipo:  TripWaypoint optional
El punto de referencia donde termina el tramo de ruta actual.
currentRouteSegmentVersion optional
Tipo:  Date optional
Hora en la que se estableció el tramo de ruta actual.
currentTrips optional
Tipo:  Array<string> optional
Es la lista de IDs de los viajes asignados actualmente a este vehículo.
etaToFirstWaypoint optional
Tipo:  Date optional
La hora de llegada estimada a la primera entrada en el campo de puntos de referencia.
latestLocation optional
Tipo:  VehicleLocationUpdate optional
Es la última ubicación del vehículo que se informó.
maximumCapacity optional
Tipo:  number optional
La cantidad total de pasajeros que puede transportar este vehículo. El controlador no se considera en este valor.
supportedTripTypes optional
Tipo:  Array<TripType> optional
Tipos de viaje admitidos por este vehículo.
waypoints optional
Tipo:  Array<TripWaypoint> optional
Los puntos de referencia restantes asignados a este vehículo.
waypointsVersion optional
Tipo:  Date optional
La última vez que se actualizó el campo de puntos de referencia.

Constantes VehicleNavigationStatus

Constantes google.maps.journeySharing.VehicleNavigationStatus

Es el estado actual de la navegación de un objeto Vehicle.

Para acceder, llama a const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

ARRIVED_AT_DESTINATION El vehículo está a una distancia aproximada de 50 m del destino.
ENROUTE_TO_DESTINATION La navegación paso a paso está disponible, y la navegación de la app de Driver entró en el modo GUIDED_NAV.
NO_GUIDANCE La navegación de la app de Driver está en modo FREE_NAV.
OFF_ROUTE El vehículo se desvió de la ruta sugerida.
UNKNOWN_NAVIGATION_STATUS Estado de navegación no especificado.

Constantes VehicleState

Constantes google.maps.journeySharing.VehicleState

El estado actual de un Vehicle.

Para acceder, llama a const {VehicleState} = await google.maps.importLibrary("journeySharing"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

OFFLINE El vehículo no acepta viajes nuevos.
ONLINE El vehículo está aceptando viajes nuevos.
UNKNOWN_VEHICLE_STATE Se desconoce el estado del vehículo.

Constantes VehicleType

Constantes google.maps.journeySharing.VehicleType

Corresponde al tipo de Vehicle.

Para acceder, llama a const {VehicleType} = await google.maps.importLibrary("journeySharing"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

AUTO Un automóvil.
TAXI Cualquier vehículo que funcione como taxi (normalmente regulado o con licencia)
TRUCK Un vehículo con una gran capacidad de almacenamiento
TWO_WHEELER Una motocicleta, un ciclomotor u otro vehículo de dos ruedas.
UNKNOWN Tipo de vehículo desconocido

Constantes TripType

Constantes google.maps.journeySharing.TripType

Tipos de viaje compatibles con un Vehicle.

Para acceder, llama a const {TripType} = await google.maps.importLibrary("journeySharing"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

EXCLUSIVE El viaje es exclusivo para un vehículo.
SHARED Es posible que el viaje comparta un vehículo con otros viajes.
UNKNOWN_TRIP_TYPE Tipo de viaje desconocido.

TripWaypoint

Interfaz de google.maps.journeySharing.TripWaypoint

Tipo de punto de referencia de viaje.

distanceMeters optional
Tipo:  number optional
La distancia de la ruta entre el punto de referencia anterior (o la ubicación actual del vehículo, si es el primero de la lista de puntos de referencia) al punto de referencia en metros.
durationMillis optional
Tipo:  number optional
Tiempo de viaje entre el punto de referencia anterior (o la ubicación actual del vehículo, si es el primero de la lista de puntos de referencia) hasta este punto de referencia en milisegundos.
location optional
Tipo:  LatLng optional
La ubicación del punto de referencia.
path optional
Tipo:  Array<LatLng> optional
Indica la ruta desde la parada anterior (o la ubicación actual del vehículo, si esta es la primera de la lista de paradas) hasta esta parada.
speedReadingIntervals optional
Tipo:  Array<SpeedReadingInterval> optional
La lista de velocidades de tráfico a lo largo de la ruta desde el punto de referencia anterior (o la ubicación del vehículo) hasta el punto de referencia actual. Cada intervalo de la lista describe el tráfico de un segmento contiguo en la ruta; el intervalo define los puntos de inicio y finalización del tramo a través de sus índices. Para obtener más información, consulta la definición de SpeedReadingInterval.
tripId optional
Tipo:  string optional
El viaje asociado con este punto de referencia.
waypointType optional
Tipo:  WaypointType optional
La función que desempeña este punto de referencia en este viaje, como el punto de partida o el destino.

Constantes WaypointType

Constantes google.maps.journeySharing.WaypointType

Tipos de puntos de referencia compatibles con Vehicle.

Para acceder, llama a const {WaypointType} = await google.maps.importLibrary("journeySharing"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

DROP_OFF_WAYPOINT_TYPE Puntos de referencia para dejar pasajeros.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Puntos de referencia para destinos intermedios en un viaje con varios destinos.
PICKUP_WAYPOINT_TYPE Puntos de referencia para recoger pasajeros.
UNKNOWN_WAYPOINT_TYPE Tipo de punto de referencia desconocido.

TimeWindow

Interfaz de google.maps.journeySharing.TimeWindow

Un intervalo de tiempo.

endTime
Tipo:  Date
Indica la hora de finalización del período (inclusive).
startTime
Tipo:  Date
Indica la hora de inicio del período (inclusive).

Constantes de velocidad

Constantes google.maps.journeySharing.Speed

Es la clasificación de la velocidad de las polilíneas según los datos de tráfico.

Para acceder, llama a const {Speed} = await google.maps.importLibrary("journeySharing"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

NORMAL Velocidad normal; no se detecta ninguna demora.
SLOW Se detectó una demora, pero no se formó un embotellamiento.
TRAFFIC_JAM Se detectó un embotellamiento.

SpeedReadingInterval

Interfaz de google.maps.journeySharing.SpeedReadingInterval

Indicador de densidad de tráfico en un segmento de ruta contiguo. El intervalo define los puntos de inicio y finalización del tramo mediante sus índices.

endPolylinePointIndex
Tipo:  number
El índice basado en cero del punto de finalización del intervalo en la ruta.
speed
Tipo:  Speed
Velocidad del tráfico en este intervalo.
startPolylinePointIndex
Tipo:  number
El índice basado en cero del punto de partida del intervalo en la ruta.