Method: providers.trips.search

Accede a todos los viajes para 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

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

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Si se establece como verdadera, la respuesta incluirá viajes que influyen en la ruta del conductor.
pageSize

integer

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

string

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

Es una duración en segundos con hasta nueve dígitos decimales que termina 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)

Es la lista de viajes del vehículo solicitado.
nextPageToken

string

Pasa este token en SearchTripsRequest para paginar 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 está vacía.