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 forma parte 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

El vehículo asociado con los viajes en la solicitud. Si no se especifica, los viajes devueltos no contendrán lo siguiente:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Si la estableces como verdadera, la respuesta incluirá los Viajes que influyen en la ruta del conductor.

pageSize

integer

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

pageToken

string

Establece esto en un valor que se mostró anteriormente en el 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.