Fleet Engine Entities

Interfaz Task

Interfaz 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
Es el 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 un 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 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, una pausa o un envío.
estimatedCompletionTime
opcional
Tipo: Date optional
Es la marca de tiempo de la hora de finalización estimada de la tarea.
latestVehicleLocationUpdate
opcional
Tipo: VehicleLocationUpdate optional
Es la información específica de la última ubicación actualizada.
outcome
opcional
Tipo: string optional
El resultado de la tarea.
outcomeLocation
opcional
Tipo: LatLngLiteral optional
Es la ubicación en la que se completó la tarea (del proveedor).
outcomeLocationSource
opcional
Tipo: string optional
Es el configurador de la ubicación del resultado de la tarea ("PROVIDER" o "LAST_VEHICLE_LOCATION").
outcomeTime
opcional
Tipo: Date optional
Es la marca de tiempo del momento en que se estableció el resultado de la tarea (del proveedor).
plannedLocation
opcional
Tipo: LatLngLiteral optional
Es la ubicación donde se debe completar la tarea.
targetTimeWindow
opcional
Tipo: TimeWindow optional
Es el período durante el cual se debe completar la tarea.
trackingId
opcional
Tipo: string optional
Es el ID de seguimiento del envío.
vehicleId
opcional
Tipo: string optional
Es el ID del vehículo que realiza esta tarea.

Interfaz TaskInfo

Interfaz google.maps.journeySharing.TaskInfo

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

Interfaz TaskTrackingInfo

Interfaz 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
Es el nombre en 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.
  • La longitud máxima es de 64 caracteres.
  • Se normaliza según la forma de normalización C de Unicode.
  • No puede contener ninguno de los siguientes caracteres ASCII: '/', ':', '?', ',' o '#'.
estimatedArrivalTime
opcional
Tipo: Date optional
Es la hora de llegada estimada a la ubicación de la parada.
estimatedTaskCompletionTime
opcional
Tipo: Date optional
Es la hora de finalización estimada de una tarea.
latestVehicleLocationUpdate
opcional
Tipo: VehicleLocationUpdate optional
Es la información específica de la última ubicación actualizada.
plannedLocation
opcional
Tipo: LatLng optional
Es la ubicación en la que se completará la tarea.
remainingDrivingDistanceMeters
opcional
Tipo: number optional
Es la distancia restante total en metros hasta el VehicleStop de interés.
remainingStopCount
opcional
Tipo: number optional
Indica la cantidad de paradas que le quedan al vehículo hasta llegar a la parada de la tarea, incluida esta última. Por ejemplo, si la próxima parada del vehículo es la parada de la tarea, el valor será 1.
routePolylinePoints
opcional
Tipo: Array<LatLng> optional
Es una lista de puntos que, cuando se conectan, forman una polilínea de la ruta prevista del vehículo hasta la ubicación de esta tarea.
state
opcional
Tipo: string optional
Es el estado actual de ejecución de la tarea.
targetTimeWindow
opcional
Tipo: TimeWindow optional
Es el período durante el cual se debe completar la tarea.
taskOutcome
opcional
Tipo: string optional
Es el resultado de intentar ejecutar una tarea.
taskOutcomeTime
opcional
Tipo: Date optional
Es la hora en la que el proveedor estableció el resultado de la tarea.

Interfaz Trip

Interfaz google.maps.journeySharing.Trip

Son los detalles de un viaje que devuelve Fleet Engine.
name
Tipo: string
En 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 llegada.
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
opcional
Tipo: LatLngLiteral optional
Es la ubicación donde se dejó al cliente.
actualPickupLocation
opcional
Tipo: LatLngLiteral optional
Es la ubicación donde se recogió al cliente.
dropOffTime
opcional
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
opcional
Tipo: VehicleLocationUpdate optional
Es la información específica de la última ubicación actualizada.
pickupTime
opcional
Tipo: Date optional
Es la hora futura estimada en la que se recogerá a los pasajeros o la hora real en la que se los recogió.
plannedDropOffLocation
opcional
Tipo: LatLngLiteral optional
Ubicación donde el cliente indica que se lo dejará.
plannedPickupLocation
opcional
Tipo: LatLngLiteral optional
Ubicación donde el cliente indica que lo recogerán.

Interfaz DeliveryVehicle

Interfaz google.maps.journeySharing.DeliveryVehicle

Son los detalles de un vehículo de entrega que devuelve Fleet Engine.
attributes
Tipo: Object<string, string optional>
Atributos personalizados del vehículo de entrega.
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 de ruta actual, en metros.
remainingVehicleJourneySegments
Son los tramos del viaje asignados a este vehículo de entrega, que comienzan desde la ubicación informada más recientemente del vehículo. Este campo solo se completa cuando el objeto de datos DeliveryVehicle se proporciona a través de FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint
opcional
Tipo: LatLngLiteral optional
Es la ubicación donde finaliza el tramo de ruta actual.
latestVehicleLocationUpdate
opcional
Tipo: VehicleLocationUpdate optional
Es la última ubicación informada del vehículo de entrega.
remainingDurationMillis
opcional
Tipo: number optional
Es la duración restante de la conducción en el tramo de ruta actual, en milisegundos.

Interfaz DeliveryVehicleStop

Interfaz google.maps.journeySharing.DeliveryVehicleStop

Tipo DeliveryVehicleStop
tasks
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
opcional
Tipo: LatLngLiteral optional
Es la ubicación de la parada.
state
opcional
Es el estado de la parada.

Constantes de DeliveryVehicleStopState

google.maps.journeySharing.DeliveryVehicleStopState constantes biblioteca
"journeySharing"

Es el estado actual de un DeliveryVehicleStop.

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo DeliveryVehicleStopStateString.

const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing");
ARRIVED Llegaste a una parada. Se supone que, cuando el vehículo se dirige a la siguiente parada, ya se completaron todas las paradas anteriores.
ENROUTE Asignado y enrutando activamente.
NEW Se creó, pero no se enruta de forma activa.
UNSPECIFIED Desconocido.

Interfaz VehicleJourneySegment

Interfaz google.maps.journeySharing.VehicleJourneySegment

Tipo VehicleJourneySegment
drivingDistanceMeters
opcional
Tipo: number optional
Es la distancia de viaje desde la parada anterior hasta esta parada, en metros.
drivingDurationMillis
opcional
Tipo: number optional
Es la duración del viaje desde la parada anterior hasta esta, en milisegundos.
path
opcional
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
opcional
Tipo: DeliveryVehicleStop optional
Es la información sobre la parada.

Interfaz VehicleLocationUpdate

Interfaz google.maps.journeySharing.VehicleLocationUpdate

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

Interfaz VehicleWaypoint

Interfaz google.maps.journeySharing.VehicleWaypoint

Es el tipo de VehicleWaypoint.
distanceMeters
opcional
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
opcional
Tipo: number optional
Es la duración del 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
opcional
Tipo: LatLngLiteral optional
Es la ubicación del punto de referencia.
path
opcional
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
opcional
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 de inicio y finalización del segmento a través de sus índices. Consulta la definición de SpeedReadingInterval para obtener más detalles.

Interfaz de vehículo

Interfaz google.maps.journeySharing.Vehicle

Son los detalles de un vehículo que devuelve Fleet Engine.
attributes
Tipo: Object<string, *>
Son los atributos personalizados del vehículo.
name
Tipo: string
En el formato "providers/{provider_id}/vehicles/{vehicle_id}". El 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
Es el estado del vehículo.
vehicleType
Es el tipo de este vehículo.
currentRouteSegmentEndPoint
opcional
Tipo: TripWaypoint optional
Es el punto de referencia donde finaliza el tramo de ruta actual.
currentRouteSegmentVersion
opcional
Tipo: Date optional
Es la hora en la que se estableció el tramo de ruta actual.
currentTrips
opcional
Tipo: Array<string> optional
Es la lista de IDs de los viajes asignados actualmente a este vehículo.
etaToFirstWaypoint
opcional
Tipo: Date optional
Es la hora estimada de llegada a la primera entrada del campo de puntos de referencia.
latestLocation
opcional
Tipo: VehicleLocationUpdate optional
Es la última ubicación informada del vehículo.
maximumCapacity
opcional
Tipo: number optional
Es la cantidad total de pasajeros que puede transportar este vehículo. El conductor no se tiene en cuenta en este valor.
supportedTripTypes
opcional
Tipo: Array<TripType> optional
Son los tipos de viajes que admite este vehículo.
waypoints
opcional
Tipo: Array<TripWaypoint> optional
Son los puntos de referencia restantes asignados a este vehículo.
waypointsVersion
opcional
Tipo: Date optional
Es la última vez que se actualizó el campo de puntos de referencia.

Constantes de VehicleNavigationStatus

google.maps.journeySharing.VehicleNavigationStatus constantes biblioteca
"journeySharing"

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

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo VehicleNavigationStatusString.

const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing");
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 de conductor ingresó al 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

google.maps.journeySharing.VehicleState constantes biblioteca
"journeySharing"

Es el estado actual de un Vehicle.

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo VehicleStateString.

const {VehicleState} = await google.maps.importLibrary("journeySharing");
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

google.maps.journeySharing.VehicleType constantes biblioteca
"journeySharing"

Corresponde al tipo de Vehicle.

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo VehicleTypeString.

const {VehicleType} = await google.maps.importLibrary("journeySharing");
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

google.maps.journeySharing.TripType constantes biblioteca
"journeySharing"

Son los tipos de viajes que admite un Vehicle.

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo TripTypeString.

const {TripType} = await google.maps.importLibrary("journeySharing");
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 TripWaypoint

Interfaz google.maps.journeySharing.TripWaypoint

Es el tipo de TripWaypoint.
distanceMeters
opcional
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
opcional
Tipo: number optional
Es la duración del 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
opcional
Tipo: LatLng optional
Es la ubicación del punto de referencia.
path
opcional
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
opcional
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 de inicio y finalización del segmento a través de sus índices. Consulta la definición de SpeedReadingInterval para obtener más detalles.
tripId
opcional
Tipo: string optional
Es el viaje asociado con este punto de referencia.
waypointType
opcional
Tipo: WaypointType optional
Es el rol que desempeña este punto de referencia en este viaje, como retiro o llegada.

Constantes de WaypointType

google.maps.journeySharing.WaypointType constantes biblioteca
"journeySharing"

Tipos de puntos de referencia admitidos por Vehicle.

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo WaypointTypeString.

const {WaypointType} = await google.maps.importLibrary("journeySharing");
DROP_OFF_WAYPOINT_TYPE Son los puntos de referencia para dejar pasajeros.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Son puntos de referencia para 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 google.maps.journeySharing.TimeWindow

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

google.maps.journeySharing.Speed constantes biblioteca
"journeySharing"

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

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo SpeedString.

const {Speed} = await google.maps.importLibrary("journeySharing");
NORMAL Velocidad normal, no se detecta ninguna ralentización.
SLOW Se detectó una ralentización, pero no se formó un embotellamiento.
TRAFFIC_JAM Se detectó un embotellamiento.

Interfaz SpeedReadingInterval

Interfaz google.maps.journeySharing.SpeedReadingInterval

Es el indicador de densidad del tráfico en un segmento de ruta contiguo. El intervalo define los puntos de inicio y finalización 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 de acceso.
speed
Tipo: Speed
Es la velocidad del tráfico en este intervalo.
startPolylinePointIndex
Tipo: number
Es el índice basado en cero del punto de partida del intervalo en la ruta de acceso.