Method: providers.trips.search

Visualizza tutte le corse di un veicolo specifico.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Deve essere nel formato providers/{provider}. Il provider deve essere l'ID progetto (ad esempio sample-cloud-project) del progetto Google Cloud di cui l'account di servizio che effettua la chiamata è membro.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "header": {
    object (RequestHeader)
  },
  "vehicleId": string,
  "activeTripsOnly": boolean,
  "pageSize": integer,
  "pageToken": string,
  "minimumStaleness": string
}
Campi
header

object (RequestHeader)

L'intestazione della richiesta standard di Fleet Engine.
vehicleId

string

Il veicolo associato alle corse nella richiesta. Se non specificate, le corse restituite non contengono:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Se è impostata su true, la risposta include le corse che influenzano il percorso di un conducente.
pageSize

integer

Se non viene impostato, il server decide il numero di risultati da restituire.
pageToken

string

Impostalo su un valore restituito in precedenza in SearchTripsResponse per continuare con i risultati precedenti.
minimumStaleness

string (Duration format)

Se specificato, restituisce le corse che non sono state aggiornate dopo l'ora (current - minimumStaleness).

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

Corpo della risposta

messaggio di risposta trip.search.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "trips": [
    {
      object (Trip)
    }
  ],
  "nextPageToken": string
}
Campi
trips[]

object (Trip)

L'elenco di corse per il veicolo richiesto.
nextPageToken

string

Passa questo token nella SearchTripsRequest per sfogliare i risultati dell'elenco. L'API restituisce un elenco delle corse per ogni chiamata. Quando non rimangono più risultati, l'elenco delle corse è vuoto.