REST Resource: providers.trips

{
  "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)
}

string

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

string

Es el ID del vehículo que realiza este viaje.

enum (TripStatus)

Es el estado actual del viaje.

enum (TripType)

Es el tipo de viaje.

object (TerminalLocation)

Es la ubicación donde el cliente indica que lo recogerán.

object (StopLocation)

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.

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.

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".

object (TerminalLocation)

Son las paradas intermedias que solicita el viaje (además de la de partida y destino). En un principio, esto no será compatible con los viajes compartidos.

string (Timestamp format)

Indica la última vez que se modificó 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".

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, este campo se ignora.

object (StopLocation)

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.

object (StopLocation)

Solo entrada. La hora y la ubicación reales en las que 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.

object (TerminalLocation)

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

object (StopLocation)

Solo entrada. La hora y la ubicación reales en que cuándo y dónde se dejó al cliente. Este campo es para que el proveedor proporcione comentarios sobre la información real del lugar de destino.

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".

object (TripWaypoint)

Solo salida. Es la ruta completa desde la ubicación actual hasta el punto de destino inclusive. Esta ruta puede incluir puntos de referencia de otros viajes.

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, el servidor solo propaga este campo en las llamadas trips.update y trips.create, NO en las llamadas trips.get.

object (LatLng)

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.

string

Solo salida. Es una ruta codificada al siguiente punto de referencia.

Nota: Este campo está diseñado solo para que lo usen el SDK de Driver y el SDK para consumidores. Aún no se admite la decodificación.

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 de Driver 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".

object (ConsumableTrafficPolyline)

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

Nota: Este campo solo está diseñado para que lo usen el SDK de Driver y el SDK de Consumer.

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 de Driver 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".

object (TripWaypoint)

Solo salida. El punto de referencia donde termina currentRouteSegment.

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 se completó o canceló.

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".

string (Duration format)

Solo salida. Es la duración desde el momento en 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 está inactivo (completo o cancelado).

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

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".

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".

integer

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

object (VehicleLocation)

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

boolean

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

enum (TripView)

Subconjunto de campos de Viaje que se completan y cómo deben interpretarse.

{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}

object (LatLng)

Obligatorio. Indica la ubicación real.

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".

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".