Fleet Engine Entities

Interfaz de Task

Interfaz de google.maps.journeySharing.Task

Son los detalles de una tarea que devuelve Fleet Engine.
attributes
Tipo:  Object<string, *>
Son los atributos asignados a la tarea.
name
Tipo:  string
Nombre de la tarea en 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
Es información sobre los segmentos que faltan completar para esta tarea.
status
Tipo:  string
Es el estado actual de ejecución de la tarea.
type
Tipo:  string
Es el tipo de tarea, por ejemplo, un descanso o un envío.
estimatedCompletionTime optional
Tipo:  Date optional
Es la marca de tiempo de la hora de finalización estimada de la tarea.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Es información específica sobre la última actualización de la ubicación.
outcome optional
Tipo:  string optional
Es 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
Es el setter 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 en la que 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

Es el tipo TaskInfo que usa DeliveryVehicleStop.
extraDurationMillis optional
Tipo:  number optional
Es el tiempo adicional que se necesita para 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

Son los detalles de un objeto de información de seguimiento de tareas que devuelve Fleet Engine.
attributes
Tipo:  Object<string, *>
Son los atributos asignados a la tarea.
name
Tipo:  string
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.
  • Se limita a una longitud máxima de 64 caracteres.
  • Se normaliza según la forma C de normalización 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 información específica sobre la última actualización de la ubicación.
plannedLocation optional
Tipo:  LatLng optional
Es la ubicación donde se completará la tarea.
remainingDrivingDistanceMeters optional
Tipo:  number optional
Es la distancia restante total en metros hasta el VehicleStop de interés.
remainingStopCount optional
Tipo:  number optional
Indica la cantidad de paradas que faltan para llegar a la parada de la tarea, incluida esta. 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 hacia la ubicación de esta tarea.
state optional
Tipo:  string optional
Es el estado actual de ejecución 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
Es el resultado de intentar ejecutar una tarea.
taskOutcomeTime optional
Tipo:  Date optional
Es la fecha y hora en que el proveedor estableció el resultado de la tarea.

Interfaz de viaje

Interfaz de google.maps.journeySharing.Trip

Son los detalles de un viaje que devuelve Fleet Engine.
name
Tipo:  string
Tiene el formato "providers/{provider_id}/trips/{trip_id}". El 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 indica la ruta desde la ubicación actual hasta el punto de entrega.
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
ID del vehículo que realiza este viaje.
actualDropOffLocation optional
Tipo:  LatLngLiteral optional
Ubicación en la que 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 en la que se dejará a los pasajeros o la hora real en la que se los dejó.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Es información específica sobre la última actualización de la ubicación.
pickupTime optional
Tipo:  Date optional
Es la hora futura estimada en la que se recogerá a los pasajeros o la hora real en la que se recogieron.
plannedDropOffLocation optional
Tipo:  LatLngLiteral optional
Ubicación en la que el cliente indica que se bajará.
plannedPickupLocation optional
Tipo:  LatLngLiteral optional
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 reparto que devuelve Fleet Engine.
attributes
Tipo:  Object<string, string optional>
Son atributos personalizados del vehículo de entrega.
name
Tipo:  string
Tiene 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 de ruta actual, en metros.
remainingVehicleJourneySegments
Son los tramos del viaje asignados a este vehículo de reparto, comenzando por la ubicación del vehículo informada más recientemente. Este campo solo se completa 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 de ruta actual.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Es la última ubicación informada del vehículo de reparto.
remainingDurationMillis optional
Tipo:  number optional
Es la duración restante de la conducción en el tramo de ruta actual, en milisegundos.

Interfaz DeliveryVehicleStop

Interfaz de google.maps.journeySharing.DeliveryVehicleStop

Tipo 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 lleva realizar la tarea, en milisegundos.
plannedLocation optional
Tipo:  LatLngLiteral optional
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.

Llama al const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
ARRIVED Llegaste a la parada. Se supone que, cuando el vehículo está trazando la ruta hacia la siguiente parada, se completaron todas las paradas anteriores.
ENROUTE Se asignó y se está enrutando de forma activa.
NEW Se creó, pero no se está generando la ruta de forma activa.
UNSPECIFIED Desconocido.

Interfaz de VehicleJourneySegment

Interfaz de google.maps.journeySharing.VehicleJourneySegment

Tipo VehicleJourneySegment
drivingDistanceMeters optional
Tipo:  number optional
Es la distancia de viaje 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, 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) hasta esta parada.
stop optional
Tipo:  DeliveryVehicleStop optional
Es información sobre la parada.

Interfaz VehicleLocationUpdate

Interfaz de google.maps.journeySharing.VehicleLocationUpdate

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

Interfaz de VehicleWaypoint

Interfaz de google.maps.journeySharing.VehicleWaypoint

Es el tipo de VehicleWaypoint.
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) y este punto de referencia, en metros.
durationMillis optional
Tipo:  number optional
Es el tiempo de viaje 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) y este punto de referencia, en milisegundos.
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) hasta este punto de referencia.
speedReadingIntervals optional
Tipo:  Array<SpeedReadingInterval> optional
Es la lista de velocidades del 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 de Vehicle

Interfaz de google.maps.journeySharing.Vehicle

Son los detalles de un vehículo que devuelve Fleet Engine.
attributes
Tipo:  Object<string, *>
Atributos personalizados del vehículo
name
Tipo:  string
Tiene el formato "providers/{provider_id}/vehicles/{vehicle_id}". El campo 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 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
Es el punto de ruta donde finaliza el tramo de ruta actual.
currentRouteSegmentVersion optional
Tipo:  Date optional
Fecha y hora en que se estableció el tramo de ruta actual.
currentTrips optional
Tipo:  Array<string> optional
Es la lista de IDs de los viajes que se le asignaron a este vehículo.
etaToFirstWaypoint optional
Tipo:  Date optional
Es la ETA hasta la primera entrada en el campo de waypoints.
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 este 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
Son los puntos de ruta 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.

Llama al const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
ARRIVED_AT_DESTINATION El vehículo se encuentra a aproximadamente 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 modo FREE_NAV.
OFF_ROUTE El vehículo se desvió 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.

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

Constantes de VehicleType

Constantes de google.maps.journeySharing.VehicleType

Corresponde al tipo de Vehicle.

Llama al const {VehicleType} = await google.maps.importLibrary("journeySharing") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
AUTO Un automóvil
TAXI Cualquier vehículo que funcione como taxi (por lo general, con licencia o regulado)
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

Tipos de viajes admitidos por un objeto Vehicle.

Llama al const {TripType} = await google.maps.importLibrary("journeySharing") para acceder.
Consulta Bibliotecas en 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.

Interfaz de TripWaypoint

Interfaz de google.maps.journeySharing.TripWaypoint

Es el tipo TripWaypoint.
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) y este punto de referencia, en metros.
durationMillis optional
Tipo:  number optional
Es el tiempo de viaje 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) y este punto de referencia, en milisegundos.
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) hasta esta parada.
speedReadingIntervals optional
Tipo:  Array<SpeedReadingInterval> optional
Es la lista de velocidades del 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 ruta.
waypointType optional
Tipo:  WaypointType optional
Es el rol que cumple este punto de ruta en el viaje, como la partida o el destino.

Constantes de WaypointType

Constantes de google.maps.journeySharing.WaypointType

Son los tipos de puntos de referencia admitidos por Vehicle.

Llama al const {WaypointType} = await google.maps.importLibrary("journeySharing") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
DROP_OFF_WAYPOINT_TYPE Son los puntos de referencia para dejar a los pasajeros.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Son los puntos de referencia para los destinos intermedios en un viaje con varios destinos.
PICKUP_WAYPOINT_TYPE Son los puntos de referencia para recoger pasajeros.
UNKNOWN_WAYPOINT_TYPE Tipo de punto de referencia desconocido.

Interfaz TimeWindow

Interfaz de google.maps.journeySharing.TimeWindow

Es un período.
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

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

Llama al const {Speed} = await google.maps.importLibrary("journeySharing") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
NORMAL Velocidad normal, no se detectó ninguna desaceleración.
SLOW Se detectó una desaceleración, pero no se formó un embotellamiento.
TRAFFIC_JAM Se detectó un embotellamiento.

Interfaz SpeedReadingInterval

Interfaz de google.maps.journeySharing.SpeedReadingInterval

Indicador de densidad del tráfico en un tramo de ruta contiguo. El intervalo define los puntos de inicio y finalización del segmento a través de sus índices.
endPolylinePointIndex
Tipo:  number
Í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
Índice basado en cero del punto de partida del intervalo en la ruta.