Recurso: Trip
Metadatos del viaje.
Representación JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Campos | |
---|---|
name |
Solo salida. En el formato "providers/{provider}/trips/{trip}" |
vehicleId |
ID del vehículo que realiza este viaje. |
tripStatus |
Estado actual del viaje. |
tripType |
El tipo de viaje. |
pickupPoint |
Ubicación en la que el cliente indica que lo retirarán. |
actualPickupPoint |
Solo entrada. La ubicación real del momento y el lugar en el que se recogió al cliente. Este campo permite que el proveedor proporcione comentarios sobre la información real de retiro. |
actualPickupArrivalPoint |
Solo entrada. La hora y la ubicación reales en que el conductor llega al punto de partida. Este campo permite que el proveedor proporcione comentarios sobre la información real de la llegada al punto de partida. |
pickupTime |
Solo salida. Puede ser la hora estimada en el futuro a la que se recogerá a los pasajeros o la hora real en la que se buscaron. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
intermediateDestinations[] |
Paradas intermedias en función de las solicitudes del viaje (además de los puntos de partida y destino). En un principio, esto no será compatible con los viajes compartidos. |
intermediateDestinationsVersion |
Indica la última vez que se modificó el objeto Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
intermediateDestinationIndex |
Cuando |
actualIntermediateDestinationArrivalPoints[] |
Solo entrada. La hora y la ubicación reales de la llegada del conductor a un destino intermedio. Este campo permite que el proveedor proporcione comentarios sobre la información real de llegada a destinos intermedios. |
actualIntermediateDestinations[] |
Solo entrada. Indica la hora y la ubicación reales en que y dónde se recogió al cliente desde un destino intermedio. Este campo permite que el proveedor proporcione comentarios sobre la información real de retiro en destinos intermedios. |
dropoffPoint |
Ubicación en la que el cliente indica que se bajará. |
actualDropoffPoint |
Solo entrada. La hora y la ubicación reales en que cuándo y dónde llegó al cliente. Este campo permite que el proveedor proporcione comentarios sobre la información real sobre el destino. |
dropoffTime |
Solo salida. Puede ser la hora estimada en el futuro a la que se bajarán los pasajeros en el destino final o la hora real en la que se bajarán. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
remainingWaypoints[] |
Solo salida. La ruta completa desde la ubicación actual hasta el punto de destino, inclusive. Esta ruta puede incluir puntos de referencia de otros viajes. |
vehicleWaypoints[] |
Este campo admite el ordenamiento manual de los puntos de referencia para el viaje. Contiene todos los puntos de referencia restantes para el vehículo asignado, así como los puntos de referencia de partida y llegada para este viaje. Si el viaje no se asignó a un vehículo, Fleet Engine ignora este campo. Por motivos de privacidad, solo el servidor propaga este campo en las llamadas |
route[] |
Solo salida. Ruta prevista para este viaje a la primera entrada en los puntos de referencia restantes. Ten en cuenta que el primer punto de referencia puede pertenecer a un viaje diferente. |
currentRouteSegment |
Solo salida. Una ruta codificada al siguiente punto de referencia. Nota: Este campo está diseñado solo para que lo usen el SDK del controlador y el SDK para consumidores. Aún no se admite la decodificación. |
currentRouteSegmentVersion |
Solo salida. Indica la última vez que se modificó la ruta. Nota: Este campo está diseñado solo para que lo usen el SDK del controlador y el SDK para consumidores. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
currentRouteSegmentTraffic |
Solo salida. Indica las condiciones de tráfico en el Nota: Este campo está diseñado solo para que lo usen el SDK del controlador y el SDK para consumidores. |
currentRouteSegmentTrafficVersion |
Solo salida. Indica la última vez que se modificó el objeto Nota: Este campo está diseñado solo para que lo usen el SDK del controlador y el SDK para consumidores. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
currentRouteSegmentEndPoint |
Solo salida. El punto de referencia donde termina |
remainingDistanceMeters |
Solo salida. La distancia de conducción restante en el campo |
etaToFirstWaypoint |
Solo salida. La hora de llegada estimada al siguiente punto de referencia (la primera entrada en el campo Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
remainingTimeToFirstWaypoint |
Solo salida. Es la duración desde que se muestran los datos del viaje hasta la hora en Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
remainingWaypointsVersion |
Solo salida. Indica la última vez que se modificó Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
remainingWaypointsRouteVersion |
Solo salida. Indica la última vez que se modificaron Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
numberOfPassengers |
Inmutable. Indica la cantidad de pasajeros en este viaje y no incluye al conductor. Un vehículo debe tener una capacidad disponible para que se muestre en una respuesta de |
lastLocation |
Solo salida. Indica la última ubicación informada del vehículo a lo largo de la ruta. |
lastLocationSnappable |
Solo salida. Indica si el |
view |
Subconjunto de campos de Viaje que se completan y cómo deben interpretarse. |
TripStatus
El estado de un viaje que indica su progreso.
Enumeraciones | |
---|---|
UNKNOWN_TRIP_STATUS |
Es el valor predeterminado, que se usa para el estado del viaje no especificado o no reconocido. |
NEW |
Viaje recién creado. |
ENROUTE_TO_PICKUP |
El conductor se dirige al punto de partida. |
ARRIVED_AT_PICKUP |
El conductor llegó al punto de partida. |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
El conductor llegó a un destino intermedio y está esperando al pasajero. |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
El conductor está en camino a un destino intermedio (no al punto de llegada). |
ENROUTE_TO_DROPOFF |
El conductor recogió al pasajero y está de camino al siguiente destino. |
COMPLETE |
Se dejó al pasajero y se completó el viaje. |
CANCELED |
El viaje se canceló antes de que lo recogiera el conductor, el pasajero o el proveedor de transporte compartido. |
StopLocation
Es la ubicación real en la que se produjo una parada (recogida o destino).
Representación JSON |
---|
{
"point": {
object ( |
Campos | |
---|---|
point |
Obligatorio. Indica la ubicación real. |
timestamp |
Indica cuándo se produjo la parada. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
stopTime |
Solo entrada. Obsoleta. Usa el campo de marca de tiempo. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
TripView
Es el selector de diferentes conjuntos de campos de Viaje en una respuesta de trips.get
. Consulta AIP-157 para obtener contexto. Es probable que se agreguen vistas adicionales.
Enumeraciones | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Es el valor predeterminado. Para ofrecer retrocompatibilidad, la API usará de forma predeterminada una vista de SDK. Para garantizar la estabilidad y la compatibilidad, se recomienda a los clientes seleccionar un TripView distinto de SDK . |
SDK |
Incluye campos que tal vez no se puedan interpretar ni admitir mediante bibliotecas disponibles públicamente. |
JOURNEY_SHARING_V1S |
Los campos de viaje se propagan para el caso de uso de Viajes compartidos. Esta vista está diseñada para las comunicaciones de servidor a servidor. |
Métodos |
|
---|---|
|
Crea un viaje en Fleet Engine y muestra el viaje nuevo. |
|
Obtén información sobre un solo viaje. |
|
Obtener todos los viajes de un vehículo específico |
|
Actualiza los datos de viajes. |