Method: providers.trips.search

Visualizza tutti i viaggi per 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 questa 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 Fleet Engine standard.

vehicleId

string

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

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Se impostato su true, la risposta include i viaggi che influenzano il percorso del conducente.

pageSize

integer

Se non viene configurato, è il server a decidere il numero di risultati da restituire.

pageToken

string

Impostalo su un valore restituito in precedenza in SearchTripsResponse per continuare dai risultati precedenti.

minimumStaleness

string (Duration format)

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

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

Corpo della risposta

messaggio di risposta trips.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 in SearchTripsRequest per sfogliare i risultati dell'elenco. L'API restituisce un elenco di corse per ogni chiamata e, quando non sono disponibili altri risultati, l'elenco delle corse è vuoto.