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 l'nextPageToken fournie par un appel précédent à vehicles.list afin de pouvoir paginer des groupes de véhicules. La valeur est indéfinie si les critères de filtrage de la requête ne sont pas identiques aux critères de filtrage de l'appel précédent de 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. Si présent, doit être 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 type 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 permet 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 présentant 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 "clé:valeur".

string

Limite la réponse aux véhicules présentant au moins l'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.

Tout comme requiredOneOfAttributes, requiredOneOfAttributeSets utilise un message qui permet une liste de listes, ce qui permet des expressions telles que 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'un 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 dont l'état est défini.

boolean

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

string

Facultatif. Requête de filtre à appliquer lors de la liste 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 le plus élevé de la fenêtre d'affichage.