Method: providers.trips.search

Obtener todos los viajes de un vehículo específico

Solicitud HTTP

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/trips:search

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Debe tener el formato providers/{provider}. El proveedor debe ser el ID del proyecto (por ejemplo, sample-cloud-project) del proyecto de Google Cloud del que pertenece la cuenta de servicio que realiza esta llamada.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "header": {
    object (RequestHeader)
  },
  "vehicleId": string,
  "activeTripsOnly": boolean,
  "pageSize": integer,
  "pageToken": string,
  "minimumStaleness": string
}
Campos
header

object (RequestHeader)

El encabezado de solicitud estándar de Fleet Engine.
vehicleId

string

Es el vehículo asociado con los viajes de la solicitud. Si no se especifica, los viajes que se muestran no contienen lo siguiente:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Si se establece como verdadero, la respuesta incluye los viajes que influyen en la ruta de un conductor.
pageSize

integer

Si no se establece, el servidor decide la cantidad de resultados que se mostrarán.
pageToken

string

Establece este valor en un valor que se haya mostrado anteriormente en SearchTripsResponse para continuar desde los resultados anteriores.
minimumStaleness

string (Duration format)

Si se especifica, muestra los viajes que no se actualizaron después del horario (current - minimumStaleness).

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

Cuerpo de la respuesta

Mensaje de respuesta de trips.search.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "trips": [
    {
      object (Trip)
    }
  ],
  "nextPageToken": string
}
Campos
trips[]

object (Trip)

La lista de viajes del vehículo solicitado.
nextPageToken

string

Pasa este token en SearchTripsRequest para navegar por los resultados de la lista. La API muestra una lista de viajes en cada llamada y, cuando no quedan más resultados, la lista de viajes queda vacía.