Method: providers.vehicles.list

string

Obligatoire. Doit se présenter sous la forme providers/{provider}. Le fournisseur doit être l'ID du projet Google Cloud (par exemple, sample-cloud-project) auquel appartient le compte de service qui effectue cet appel.

object (RequestHeader)

En-tête de requête Fleet Engine standard.

integer

Nombre maximal de véhicules à renvoyer. La valeur par défaut est 100.

string

Valeur de nextPageToken fournie par un appel précédent à vehicles.list afin que vous puissiez paginer des groupes de véhicules. La valeur n'est pas définie si les critères de filtrage de la demande ne sont pas identiques à ceux de l'appel précédent à vehicles.list.

integer

Spécifie la capacité minimale requise du véhicule. La valeur maximumCapacity de tous les véhicules renvoyés est supérieure ou égale à cette valeur. S'il est défini, il doit être supérieur ou égal à 0.

enum (TripType)

Limite la réponse aux véhicules compatibles avec au moins un des types de trajets spécifiés.

string (Duration format)

Limite la réponse aux véhicules qui ont envoyé des mises à jour de position à Fleet Engine au cours de la durée spécifiée. Les véhicules fixes qui transmettent encore leur position ne sont pas considérés comme obsolètes. S'il est présent, il doit s'agir d'une durée positive valide.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

enum (Category)

Obligatoire. Limite la réponse aux véhicules appartenant à l'une des catégories de types spécifiées. UNKNOWN : non autorisé.

string

Les appelants peuvent former des opérations logiques complexes en utilisant n'importe quelle combinaison des champs requiredAttributes, requiredOneOfAttributes et requiredOneOfAttributeSets.

requiredAttributes est une liste ; requiredOneOfAttributes utilise un message qui autorise une liste de listes. Ensemble, les deux champs permettent de composer cette expression:

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

Limite la réponse aux véhicules avec les attributs spécifiés. Ce champ est une opération de conjonction/opération AND. Un maximum de 50 attributs requiredAttributes est autorisé. Ce nombre correspond au nombre maximal d'attributs autorisé pour un véhicule. Chaque chaîne répétée doit être au format "key:value".

string

Limite la réponse aux véhicules avec au moins un des attributs spécifiés dans chaque VehicleAttributeList. Dans chaque liste, un véhicule doit correspondre à au moins un des attributs. Ce champ est une opération de disjonction/OU inclusive dans chaque VehicleAttributeList et une opération de conjonction/ET sur la collection de VehicleAttributeList. Chaque chaîne répétée doit être au format "clé1:valeur1|clé2:valeur2|clé3:valeur3".

string

requiredOneOfAttributeSets fournit des fonctionnalités supplémentaires.

Comme pour requiredOneOfAttributes, requiredOneOfAttributeSets utilise un message qui autorise une liste de listes, ce qui permet d'utiliser des expressions comme celle-ci:

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

Limite la réponse aux véhicules qui correspondent à tous les attributs d'une VehicleAttributeList. Dans chaque liste, un véhicule doit correspondre à tous les attributs. Ce champ est une opération de conjonction/ET dans chaque VehicleAttributeList et une opération de disjonction inclusive/OU dans la collection de VehicleAttributeList. Chaque chaîne répétée doit être au format "clé1:valeur1|clé2:valeur2|clé3:valeur3".

enum (VehicleState)

Limite la réponse aux véhicules dans cet état.

boolean

Ne renvoyez que les véhicules avec le ou les trajets actuels.

string

Facultatif. Requête de filtre à appliquer lorsque vous listez des véhicules. Consultez la page http://aip.dev/160 pour obtenir des exemples de syntaxe de filtre.

Ce champ est conçu pour remplacer les champs requiredAttributes, requiredOneOfAttributes et required_one_of_attributes_sets. Si une valeur non vide est spécifiée ici, les champs suivants doivent être vides: requiredAttributes, requiredOneOfAttributes et required_one_of_attributes_sets.

Ce filtre fonctionne comme une clause ET avec d'autres contraintes, telles que vehicleState ou onTripOnly.

Notez que les seules requêtes acceptées concernent les attributs du véhicule (par exemple, attributes.<key> = <value> ou attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Le nombre maximal de restrictions autorisé dans une requête de filtre est de 50.

De plus, tous les attributs sont stockés sous forme de chaînes. Par conséquent, les seules comparaisons acceptées par rapport aux attributs sont les comparaisons de chaînes. Pour effectuer une comparaison avec des valeurs numériques ou booléennes, les valeurs doivent être explicitement placées entre guillemets pour être traitées comme des chaînes (par exemple, attributes.<key> = "10" ou attributes.<key> = "true").

object (Viewport)

Facultatif. Filtre qui limite les véhicules renvoyés à ceux dont la dernière position connue se trouvait dans la zone rectangulaire définie par la fenêtre d'affichage.

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

object (LatLng)

Obligatoire. Point bas de la fenêtre d'affichage.

object (LatLng)

Obligatoire. Point haut de la fenêtre d'affichage.