Recurso: Viaje
Metadatos del viaje
Representación JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Campos | |
---|---|
name |
Solo salida. En el formato "providers/{provider}/trips/{trip}" |
vehicle |
Es el ID del vehículo que realiza este viaje. |
trip |
Es el estado actual del viaje. |
trip |
Es el tipo de viaje. |
pickup |
Es la ubicación en la que el cliente indica que lo recogerán. |
actual |
Solo entrada. La ubicación real en la que se recogió al cliente. Este campo es para que el proveedor proporcione comentarios sobre la información de partida real. |
actual |
Solo entrada. La hora y la ubicación reales de la llegada del conductor al punto de partida Este campo es para que el proveedor proporcione comentarios sobre la información real de llegada al punto de partida. |
pickup |
Solo salida. La hora futura estimada en la que se recogerán a los pasajeros o la hora real en la que se los recogió. Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
intermediate |
Son las paradas intermedias que solicita el viaje (además de la recogida y la llegada). Inicialmente, esta función no será compatible con los viajes compartidos. |
intermediate |
Indica la última vez que se modificó Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
intermediate |
Cuando |
actual |
Solo entrada. Es la hora y la ubicación reales de la llegada del conductor a un destino intermedio. Este campo es para que el proveedor proporcione comentarios sobre la información de llegada real en los destinos intermedios. |
actual |
Solo entrada. La hora y la ubicación reales en las que se recogió al cliente desde un destino intermedio. Este campo es para que el proveedor proporcione comentarios sobre la información de partida real en los destinos intermedios. |
dropoff |
Es la ubicación donde el cliente indica que lo dejarán. |
actual |
Solo entrada. La hora y la ubicación reales en las que se dejó al cliente. Este campo es para que el proveedor proporcione comentarios sobre la información real de entrega. |
dropoff |
Solo salida. La hora futura estimada en la que se dejarán a los pasajeros en el destino final o la hora real en la que se los dejó. Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
remaining |
Solo salida. Es la ruta completa desde la ubicación actual hasta el punto de destino inclusive. Esta ruta podría incluir puntos de referencia de otros viajes. |
vehicle |
Este campo admite el ordenamiento manual de los puntos de referencia del viaje. Contiene todos los puntos de referencia restantes del vehículo asignado, así como los puntos de partida y destino de este viaje. Si el viaje no se asignó a un vehículo, Fleet Engine ignora este campo. Por motivos de privacidad, el servidor solo propaga este campo en las llamadas a |
route[] |
Solo salida. Es la ruta anticipada para este viaje a la primera entrada en remainingWaypoints. Ten en cuenta que el primer punto de referencia puede pertenecer a un viaje diferente. |
current |
Solo salida. Es una ruta codificada al siguiente punto de referencia. Nota: Este campo solo está diseñado para que lo usen el SDK de Driver y el SDK de Consumer. Aún no se admite la decodificación. |
current |
Solo salida. Indica la última vez que se modificó la ruta. Nota: Este campo solo está diseñado para que lo usen el SDK de Driver y el SDK de Consumer. Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
current |
Solo salida. Indica las condiciones de tráfico a lo largo de la Nota: Este campo solo está diseñado para que lo usen el SDK de Driver y el SDK de Consumer. |
current |
Solo salida. Indica la última vez que se modificó Nota: Este campo solo está diseñado para que lo usen el SDK de Driver y el SDK de Consumer. Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
current |
Solo salida. El punto de referencia donde finaliza |
remaining |
Solo salida. Es la distancia de conducción restante en el campo |
eta |
Solo salida. La hora de llegada estimada al siguiente punto de referencia (la primera entrada en el campo Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
remaining |
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 “ |
remaining |
Solo salida. Indica la última vez que se cambió Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
remaining |
Solo salida. Indica la última vez que se modificaron Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
number |
Inmutable. Indica la cantidad de pasajeros en este viaje y no incluye al conductor. Un vehículo debe tener capacidad disponible para que se muestre en una respuesta |
last |
Solo salida. Indica la última ubicación registrada del vehículo a lo largo de la ruta. |
last |
Solo salida. Indica si el |
view |
Es el subconjunto de campos de viaje que se propagan y cómo se deben interpretar. |
TripStatus
Es el estado de un viaje que indica su progreso.
Enumeraciones | |
---|---|
UNKNOWN_TRIP_STATUS |
Es el valor predeterminado que se usa para el estado de viaje no especificado o no reconocido. |
NEW |
Viaje creado recientemente. |
ENROUTE_TO_PICKUP |
El conductor está en camino 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 se dirige a un destino intermedio (no al punto de destino). |
ENROUTE_TO_DROPOFF |
El conductor recogió al pasajero y está en camino al próximo destino. |
COMPLETE |
Se dejó al pasajero y se completó el viaje. |
CANCELED |
El conductor, el pasajero o el proveedor de viajes compartidos canceló el viaje antes de la partida. |
StopLocation
Es la ubicación real en la que se produjo una parada (para subir o bajar pasajeros).
Representación JSON |
---|
{
"point": {
object ( |
Campos | |
---|---|
point |
Obligatorio. Indica la ubicación real. |
timestamp |
Indica cuándo ocurrió la parada. Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
stopTime |
Solo entrada. Obsoleta. Usa el campo de marca de tiempo. Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
TripView
Selector para diferentes conjuntos de campos de viaje en una respuesta trips.get
. Consulta AIP-157 para obtener contexto. Es probable que se agreguen vistas adicionales.
Enumeraciones | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Es el valor predeterminado. Para brindar retrocompatibilidad, la API usará una vista de SDK de forma predeterminada. Para garantizar la estabilidad y la compatibilidad, se recomienda a los clientes que seleccionen un TripView que no sea SDK . |
SDK |
Incluye campos que pueden no ser interpretables o compatibles con bibliotecas disponibles públicamente. |
JOURNEY_SHARING_V1S |
Los campos de viaje se propagan para el caso de uso de Compartir viaje. 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. |
|
Obtén todos los viajes de un vehículo específico. |
|
Actualiza los datos del viaje. |