Fleet Engine Entities

Interfaz de Task

Interfaz de google.maps.journeySharing.Task

Son 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 el ID de seguimiento de un envío, usa el campo tracking_id. Varias tareas pueden tener el mismo tracking_id.
remainingVehicleJourneySegments
Información sobre los segmentos que quedan por completar para esta tarea.
status
Tipo:  string
Es el estado actual de ejecución de la tarea.
type
Tipo:  string
El tipo de tarea, por ejemplo, una pausa o un envío.
estimatedCompletionTime optional
Tipo:  Date optional
Es la marca de tiempo del tiempo estimado de finalización de la tarea.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Es la 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 donde se completó la tarea (del proveedor).
outcomeLocationSource optional
Tipo:  string optional
Es el configurador de la ubicación del resultado de la tarea ("PROVIDER" o "LAST_VEHICLE_LOCATION").
outcomeTime optional
Tipo:  Date optional
Es la marca de tiempo del momento en que se estableció el resultado de la tarea (del 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 TaskInfo

Interfaz de google.maps.journeySharing.TaskInfo

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

Interfaz 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
El nombre con el formato "providers/{provider_id}/taskTrackingInfo/{tracking_id}", donde tracking_id representa el ID de seguimiento.
trackingId
Tipo:  string
Es el ID de seguimiento de una tarea.
  • Debe ser una cadena Unicode válida.
  • Tiene un límite de 64 caracteres.
  • Se normalizó según el Formato 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 el tiempo estimado de finalización de una tarea.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Es la información específica de la última actualización de ubicación.
plannedLocation optional
Tipo:  LatLng optional
Es la ubicación donde se completará la tarea.
remainingDrivingDistanceMeters optional
Tipo:  number optional
Es la distancia total restante en metros hasta el VehicleStop de interés.
remainingStopCount optional
Tipo:  number optional
Indica la cantidad de paradas que le quedan al vehículo hasta llegar a la parada de la tarea, incluida la parada de la tarea. Por ejemplo, si la próxima parada del vehículo es la parada de la tarea, el valor será 1.
routePolylinePoints optional
Tipo:  Array<LatLng> optional
Es una lista de puntos que, cuando se conectan, forman una polilínea de la ruta esperada del vehículo a la ubicación de esta tarea.
state optional
Tipo:  string optional
Es el estado de ejecución actual de la tarea.
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 tarea.
taskOutcomeTime optional
Tipo:  Date optional
Es la hora en la que el proveedor estableció el resultado de la tarea.

Interfaz de viaje

Interfaz de google.maps.journeySharing.Trip

Los detalles de un viaje que muestra Fleet Engine
name
Tipo:  string
En el formato "providers/{provider_id}/trips/{trip_id}". El atributo trip_id debe ser un identificador único.
passengerCount
Tipo:  number
Cantidad de pasajeros en este viaje (no incluye al conductor).
remainingWaypoints
Es un array de puntos de referencia que indican la ruta desde la ubicación actual hasta el punto de destino.
status
Tipo:  string
Es el 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
Es la ubicación donde se dejó al cliente.
actualPickupLocation optional
Tipo:  LatLngLiteral optional
Ubicación en la que se recogió al cliente.
dropOffTime optional
Tipo:  Date optional
Es la hora futura estimada a la que se dejarán los pasajeros o la hora real en la que se los dejó.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Es la información específica de la última actualización de ubicación.
pickupTime optional
Tipo:  Date optional
Es la hora futura estimada en la que se recogerán a los pasajeros o la hora real en la que se los recogió.
plannedDropOffLocation optional
Tipo:  LatLngLiteral optional
Es la ubicación en la que el cliente indica que lo dejarán.
plannedPickupLocation optional
Tipo:  LatLngLiteral optional
Es la ubicación en la que el cliente indica que lo recogerán.

Interfaz DeliveryVehicle

Interfaz de google.maps.journeySharing.DeliveryVehicle

Son los detalles de un vehículo de entrega que muestra Fleet Engine.
attributes
Tipo:  Object<string, string optional>
Atributos de vehículos de entrega personalizados
name
Tipo:  string
En el formato "providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}". El delivery_vehicle_id debe ser un identificador único.
navigationStatus
Tipo:  string
Es el estado de navegación actual del vehículo.
remainingDistanceMeters
Tipo:  number
Es la distancia de conducción restante en el tramo actual de la ruta, en metros.
remainingVehicleJourneySegments
Los segmentos de viaje asignados a este vehículo de entrega, a partir de la ubicación informada 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
Es la ubicación donde finaliza el tramo actual de la ruta.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Es la última ubicación informada del vehículo de entrega.
remainingDurationMillis optional
Tipo:  number optional
Es la duración restante de conducción en el tramo de ruta actual, expresada en milisegundos.

Interfaz DeliveryVehicleStop

Interfaz de google.maps.journeySharing.DeliveryVehicleStop

Tipo de DeliveryVehicleStop
tasks
Tipo:  Array<TaskInfo>
Es la lista de tareas que se deben realizar 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 de DeliveryVehicleStopState

Constantes de google.maps.journeySharing.DeliveryVehicleStopState

Es el estado actual de un DeliveryVehicleStop.

Para acceder, llama a const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing"). Consulta Bibliotecas de la API de Maps JavaScript.
ARRIVED Llegada a la parada Supone que, cuando el vehículo se dirige a la siguiente parada, se completaron todas las paradas anteriores.
ENROUTE Asignado y en enrutamiento activo
NEW Se creó, pero no se enruta de forma activa.
UNSPECIFIED Desconocido.

Interfaz VehicleJourneySegment

Interfaz de google.maps.journeySharing.VehicleJourneySegment

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

Interfaz VehicleLocationUpdate

Interfaz de google.maps.journeySharing.VehicleLocationUpdate

Tipo de VehicleLocationUpdate
heading optional
Tipo:  number optional
Es el encabezado de la actualización. 0 corresponde al norte y 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
La hora en la que se recibió esta actualización del vehículo.

Interfaz de VehicleWaypoint

Interfaz de google.maps.journeySharing.VehicleWaypoint

Es el tipo de punto de ruta del vehículo.
distanceMeters optional
Tipo:  number optional
Es la distancia de la ruta entre el punto de referencia anterior (o la ubicación actual del vehículo, si este punto de referencia es el primero de la lista de puntos de referencia) hasta este punto de referencia, expresada en metros.
durationMillis optional
Tipo:  number optional
Es el tiempo de viaje en milisegundos entre el punto de referencia anterior (o la ubicación actual del vehículo, si este punto de referencia es el primero de la lista de puntos de referencia) y este punto de referencia.
location optional
Tipo:  LatLngLiteral optional
Es la ubicación del punto de referencia.
path optional
Tipo:  Array<LatLngLiteral> optional
Es la ruta desde el punto de referencia anterior (o la ubicación actual del vehículo, si este punto de referencia es el primero de la lista de puntos de referencia) hasta este punto de referencia.
speedReadingIntervals optional
Tipo:  Array<SpeedReadingInterval> optional
Es 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 en un segmento contiguo de la ruta. El intervalo define los puntos inicial y final del segmento a través de sus índices. Consulta la definición de SpeedReadingInterval para obtener más detalles.

Interfaz del vehículo

Interfaz de google.maps.journeySharing.Vehicle

Son los detalles de un vehículo que muestra el motor de flota.
attributes
Tipo:  Object<string, *>
Atributos de vehículos personalizados
name
Tipo:  string
Debe tener el formato "providers/{provider_id}/vehicles/{vehicle_id}". El valor de vehicle_id debe ser un identificador único.
navigationStatus
Es el estado de navegación actual del vehículo.
remainingDistanceMeters
Tipo:  number
Es la distancia de conducción restante en el tramo actual de la ruta, en metros.
vehicleState
Tipo:  VehicleState
Es el estado del vehículo.
vehicleType
Tipo:  VehicleType
Es el tipo de vehículo.
currentRouteSegmentEndPoint optional
Tipo:  TripWaypoint optional
Es el punto de referencia donde finaliza 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 del campo de puntos de referencia.
latestLocation optional
Tipo:  VehicleLocationUpdate optional
Es la última ubicación informada del vehículo.
maximumCapacity optional
Tipo:  number optional
Es la cantidad total de pasajeros que puede transportar el vehículo. El conductor no se considera en este valor.
supportedTripTypes optional
Tipo:  Array<TripType> optional
Son los tipos de viajes que admite este vehículo.
waypoints optional
Tipo:  Array<TripWaypoint> optional
Los puntos de referencia restantes asignados a este vehículo.
waypointsVersion optional
Tipo:  Date optional
Es la última vez que se actualizó el campo de puntos de referencia.

Constantes de VehicleNavigationStatus

Constantes de google.maps.journeySharing.VehicleNavigationStatus

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

Para acceder, llama a const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing"). Consulta Bibliotecas de la API de Maps JavaScript.
ARRIVED_AT_DESTINATION El vehículo se encuentra a unos 50 m del destino.
ENROUTE_TO_DESTINATION La navegación paso a paso está disponible y la navegación de la app para conductores entró en el modo GUIDED_NAV.
NO_GUIDANCE La navegación de la app para conductores está en el modo FREE_NAV.
OFF_ROUTE El vehículo salió de la ruta sugerida.
UNKNOWN_NAVIGATION_STATUS Estado de navegación sin especificar.

Constantes de VehicleState

Constantes de google.maps.journeySharing.VehicleState

Es el estado actual de un Vehicle.

Para acceder, llama a const {VehicleState} = await google.maps.importLibrary("journeySharing"). Consulta Bibliotecas de la API de Maps JavaScript.
OFFLINE El vehículo no acepta viajes nuevos.
ONLINE El vehículo acepta viajes nuevos.
UNKNOWN_VEHICLE_STATE Estado del vehículo desconocido.

Constantes de VehicleType

Constantes de google.maps.journeySharing.VehicleType

Corresponde al tipo de Vehicle.

Para acceder, llama a const {VehicleType} = await google.maps.importLibrary("journeySharing"). Consulta Bibliotecas de la API de Maps JavaScript.
AUTO Un automóvil.
TAXI Cualquier vehículo que funcione como taxi (por lo general, con licencia o regulación)
TRUCK Un vehículo con una gran capacidad de almacenamiento.
TWO_WHEELER Una motocicleta, un ciclomotor o cualquier otro vehículo de dos ruedas.
UNKNOWN Tipo de vehículo desconocido.

Constantes de TripType

Constantes de google.maps.journeySharing.TripType

Son los tipos de viajes compatibles con un Vehicle.

Para acceder, llama a const {TripType} = await google.maps.importLibrary("journeySharing"). Consulta Bibliotecas de la API de Maps JavaScript.
EXCLUSIVE El viaje es exclusivo de un vehículo.
SHARED Es posible que el viaje comparta un vehículo con otros viajes.
UNKNOWN_TRIP_TYPE Tipo de viaje desconocido.

Interfaz de TripWaypoint

Interfaz de google.maps.journeySharing.TripWaypoint

Es el tipo de punto de ruta del viaje.
distanceMeters optional
Tipo:  number optional
Es la distancia de la ruta entre el punto de referencia anterior (o la ubicación actual del vehículo, si este punto de referencia es el primero de la lista de puntos de referencia) hasta este punto de referencia, expresada en metros.
durationMillis optional
Tipo:  number optional
Es el tiempo de viaje en milisegundos entre el punto de referencia anterior (o la ubicación actual del vehículo, si este punto de referencia es el primero de la lista de puntos de referencia) y este punto de referencia.
location optional
Tipo:  LatLng optional
Es la ubicación del punto de referencia.
path optional
Tipo:  Array<LatLng> optional
Es la ruta desde la parada anterior (o la ubicación actual del vehículo, si esta parada es la primera de la lista de paradas) hasta esta parada.
speedReadingIntervals optional
Tipo:  Array<SpeedReadingInterval> optional
Es 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 en un segmento contiguo de la ruta. El intervalo define los puntos inicial y final del segmento a través de sus índices. Consulta la definición de SpeedReadingInterval para obtener más detalles.
tripId optional
Tipo:  string optional
Es el viaje asociado a este punto de referencia.
waypointType optional
Tipo:  WaypointType optional
El rol que desempeña este punto de referencia en este viaje, como punto de partida o destino

Constantes de WaypointType

Constantes de google.maps.journeySharing.WaypointType

Son los tipos de puntos de referencia admitidos por Vehicle.

Para acceder, llama a const {WaypointType} = await google.maps.importLibrary("journeySharing"). Consulta 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 de varios destinos
PICKUP_WAYPOINT_TYPE Puntos de referencia para recoger pasajeros
UNKNOWN_WAYPOINT_TYPE Tipo de punto de referencia desconocido.

Interfaz TimeWindow

Interfaz de google.maps.journeySharing.TimeWindow

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

Constantes de velocidad

Constantes de google.maps.journeySharing.Speed

La clasificación de la velocidad de la polilínea según los datos de tráfico

Para acceder, llama a const {Speed} = await google.maps.importLibrary("journeySharing"). Consulta Bibliotecas de la API de Maps JavaScript.
NORMAL Velocidad normal, no se detecta ninguna ralentización.
SLOW Se detectó una disminución de la velocidad, pero no se formó un embotellamiento.
TRAFFIC_JAM Se detectó un embotellamiento.

Interfaz SpeedReadingInterval

Interfaz de google.maps.journeySharing.SpeedReadingInterval

Indicador de densidad de tráfico en un tramo de ruta contiguo. El intervalo define los puntos inicial y final del segmento a través de sus índices.
endPolylinePointIndex
Tipo:  number
Es el índice basado en cero del punto final del intervalo en la ruta.
speed
Tipo:  Speed
Velocidad del tráfico en este intervalo.
startPolylinePointIndex
Tipo:  number
Es el índice basado en cero del punto inicial del intervalo en la ruta.