Method: providers.vehicles.list

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.

object (RequestHeader)

L'intestazione della richiesta standard di Fleet Engine.

integer

Il numero massimo di veicoli da restituire. Valore predefinito: 100.

string

Il valore dell'attributo nextPageToken fornito da una precedente chiamata a vehicles.list per consentirti di impaginare i gruppi di veicoli. Il valore non è definito se i criteri di filtro della richiesta non corrispondono a quelli della precedente chiamata a vehicles.list.

integer

Specifica la capacità minima richiesta del veicolo. Tutti i veicoli restituiti avranno un valore maximumCapacity maggiore o uguale a questo valore. Se impostato, deve essere maggiore o uguale a 0.

enum (TripType)

Limita la risposta ai veicoli che supportano almeno uno dei tipi di corsa specificati.

string (Duration format)

Limita la risposta ai veicoli che hanno inviato aggiornamenti di posizione a Fleet Engine entro il periodo di tempo specificato. I veicoli fermi che continuano a trasmettere la loro posizione non sono considerati inattivi. Se presente, deve essere una durata positiva valida.

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

enum (Category)

Obbligatorio. Limita la risposta ai veicoli con una delle categorie di tipi specificate. Non consentito: UNKNOWN.

string

I chiamanti possono creare operazioni logiche complesse utilizzando qualsiasi combinazione dei campi requiredAttributes, requiredOneOfAttributes e requiredOneOfAttributeSets.

requiredAttributes è un elenco; requiredOneOfAttributes utilizza un messaggio che consente un elenco di elenchi. In combinazione, i due campi consentono la composizione di questa espressione:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(requiredOneOfAttributes[0][0] OR requiredOneOfAttributes[0][1] OR
...)
AND
(requiredOneOfAttributes[1][0] OR requiredOneOfAttributes[1][1] OR
...)

Limita la risposta ai veicoli con gli attributi specificati. Questo campo è un'operazione di congiunzione/AND. È consentito un massimo di 50 valori obbligatori. Corrisponde al numero massimo di attributi consentiti su un veicolo. Ogni stringa ripetuta deve essere nel formato "key:value".

string

Limita la risposta ai veicoli con almeno uno degli attributi specificati in ogni VehicleAttributeList. All'interno di ogni elenco, un veicolo deve corrispondere ad almeno uno degli attributi. Questo campo rappresenta un'operazione di disgiunzione/OR inclusiva in ogni VehicleAttributeList e un'operazione di congiunzione/AND nella raccolta di VehicleAttributeList. Ogni stringa ripetuta deve essere nel formato "chiave1:valore1|chiave2:valore2|chiave3:valore3".

string

requiredOneOfAttributeSets fornisce funzionalità aggiuntive.

Analogamente a requiredOneOfAttributes, requiredOneOfAttributeSets utilizza un messaggio che consente un elenco di elenchi, consentendo espressioni come la seguente:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(
  (requiredOneOfAttributeSets[0][0] AND
  requiredOneOfAttributeSets[0][1] AND
  ...)
  OR
  (requiredOneOfAttributeSets[1][0] AND
  requiredOneOfAttributeSets[1][1] AND
  ...)
)

Limita la risposta ai veicoli che corrispondono a tutti gli attributi in VehicleAttributeList. In ogni elenco, un veicolo deve corrispondere a tutti gli attributi. Questo campo è un'operazione di congiunzione/AND in ogni operazione VehicleAttributeList e disgiunzione/OR inclusiva nella raccolta di VehicleAttributeList. Ogni stringa ripetuta deve essere nel formato "chiave1:valore1|chiave2:valore2|chiave3:valore3".

enum (VehicleState)

Limita la risposta ai veicoli con questo stato.

boolean

Restituisci solo i veicoli con le corse attuali.

string

Campo facoltativo. Una query di filtro da applicare quando vengono elencati veicoli. Visita la pagina http://aip.dev/160 per alcuni esempi di sintassi dei filtri.

Questo campo è stato progettato per sostituire i campi requiredAttributes, requiredOneOfAttributes e required_one_of_attributes_sets. Se qui viene specificato un valore non vuoto, i seguenti campi devono essere vuoti: requiredAttributes, requiredOneOfAttributes e required_one_of_attributes_sets.

Questo filtro funziona come una clausola AND con altri vincoli, come vehicleState o onTripOnly.

Tieni presente che le uniche query supportate sono relative agli attributi dei veicoli (ad esempio, attributes.<key> = <value> o attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Il numero massimo di limitazioni consentite in una query di filtro è 50.

Inoltre, tutti gli attributi vengono archiviati come stringhe, quindi gli unici confronti supportati con gli attributi sono quelli di stringhe. Per effettuare un confronto con valori numerici o booleani, questi devono essere racchiusi esplicitamente tra virgolette in modo da essere trattati come stringhe (ad esempio, attributes.<key> = "10" o attributes.<key> = "true").

object (Viewport)

Campo facoltativo. Un filtro che limita i veicoli restituiti a quelli la cui ultima posizione nota si trovava nell'area rettangolare definita dall'area visibile.

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

Obbligatorio. Il punto basso dell'area visibile.

object (LatLng)

Obbligatorio. Il punto più alto dell'area visibile.