REST Resource: providers.trips

Recurso: Trip

Metadatos del viaje.

Representación JSON 
{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}
Campos
name

string

Solo salida. En el formato "providers/{provider}/trips/{trip}"
vehicleId

string

ID del vehículo que realiza este viaje.
tripStatus

enum (TripStatus)

Estado actual del viaje.
tripType

enum (TripType)

El tipo de viaje.
pickupPoint

object (TerminalLocation)

Ubicación en la que el cliente indica que lo retirarán.
actualPickupPoint

object (StopLocation)

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

object (StopLocation)

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

string (Timestamp format)

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: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
intermediateDestinations[]

object (TerminalLocation)

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

string (Timestamp format)

Indica la última vez que se modificó el objeto intermediateDestinations. Tu servidor debe almacenar en caché este valor y pasarlo en UpdateTripRequest cuando actualice intermediateDestinationIndex para garantizar que no se cambie intermediateDestinations.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
intermediateDestinationIndex

integer

Cuando TripStatus es ENROUTE_TO_INTERMEDIATE_DESTINATION, un número entre [0..N-1] que indica qué destino intermedio cruzará el vehículo. Cuando TripStatus es ARRIVED_AT_INTERMEDIATE_DESTINATION, un número entre [0..N-1] que indica en qué destino intermedio se encuentra el vehículo. El proveedor establece este valor. Si no hay intermediateDestinations, se ignora este campo.
actualIntermediateDestinationArrivalPoints[]

object (StopLocation)

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[]

object (StopLocation)

Solo entrada. Indica la hora y la ubicación reales en que se recogió al cliente en un destino intermedio. Este campo permite que el proveedor proporcione comentarios sobre la información real de retiro en destinos intermedios.
dropoffPoint

object (TerminalLocation)

Ubicación en la que el cliente indica que se bajará.
actualDropoffPoint

object (StopLocation)

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

string (Timestamp format)

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: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
remainingWaypoints[]

object (TripWaypoint)

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[]

object (TripWaypoint)

Este campo admite la ordenación 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 trips.update y trips.create, NO en las llamadas trips.get.
route[]

object (LatLng)

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

string

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

string (Timestamp format)

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: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
currentRouteSegmentTraffic

object (ConsumableTrafficPolyline)

Solo salida. Indica las condiciones de tráfico en el currentRouteSegment cuando están disponibles.

Nota: Este campo está diseñado solo para que lo usen el SDK del controlador y el SDK para consumidores.
currentRouteSegmentTrafficVersion

string (Timestamp format)

Solo salida. Indica la última vez que se modificó el objeto currentRouteSegmentTraffic.

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: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
currentRouteSegmentEndPoint

object (TripWaypoint)

Solo salida. El punto de referencia donde termina currentRouteSegment.
remainingDistanceMeters

integer

Solo salida. La distancia de conducción restante en el campo currentRouteSegment. El valor no se especifica si el viaje no está asignado a un vehículo o si el viaje se completa o se cancela.
etaToFirstWaypoint

string (Timestamp format)

Solo salida. La hora de llegada estimada al siguiente punto de referencia (la primera entrada en el campo remainingWaypoints). El valor no se especifica si el viaje no está asignado a un vehículo o si el viaje está inactivo (completado o cancelado).

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
remainingTimeToFirstWaypoint

string (Duration format)

Solo salida. Es la duración desde que se muestran los datos del viaje hasta la hora en Trip.eta_to_first_waypoint. El valor no se especifica si el viaje no está asignado a un vehículo o si el viaje está inactivo (completado o cancelado).

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
remainingWaypointsVersion

string (Timestamp format)

Solo salida. Indica la última vez que se modificó remainingWaypoints (se agregó, se quitó o se cambió un punto de referencia).

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
remainingWaypointsRouteVersion

string (Timestamp format)

Solo salida. Indica la última vez que se modificaron remainingWaypoints.path_to_waypoint y remainingWaypoints.traffic_to_waypoint. Tu app cliente debe almacenar en caché este valor y pasarlo en GetTripRequest para garantizar que las rutas y el tráfico de remainingWaypoints solo se muestren si se actualizan.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
numberOfPassengers

integer

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 vehicles.search.
lastLocation

object (VehicleLocation)

Solo salida. Indica la última ubicación informada del vehículo a lo largo de la ruta.
lastLocationSnappable

boolean

Solo salida. Indica si el lastLocation del vehículo se puede ajustar al currentRouteSegment. Es falso si lastLocation o currentRouteSegment no existen. Fleet Engine lo calcula. Se ignorarán las actualizaciones de los clientes.
view

enum (TripView)

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 (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}
Campos
point

object (LatLng)

Obligatorio. Indica la ubicación real.
timestamp

string (Timestamp format)

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: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
stopTime
(deprecated)

string (Timestamp format)

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: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

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

create

 Crea un viaje en Fleet Engine y muestra el viaje nuevo.

get

 Obtén información sobre un solo viaje.
Obtener todos los viajes de un vehículo específico

update

 Actualiza los datos de viajes.