Method: providers.trips.search

Tutte le corse 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 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 ai viaggi nella richiesta. Se il valore non è specificato, le corse restituite non contengono:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

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

integer

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

string

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

string (Duration format)

Se specificato, restituisce le corse che non sono state aggiornate dopo il giorno (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 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

Trasmetti questo token nella pagina SearchTripsRequest per sfogliare i risultati dell'elenco. L'API restituisce un elenco delle corse per ogni chiamata e, quando non restano altri risultati, la lista delle corse risulta vuota.