Method: providers.vehicles.list

string

必需。必须采用 providers/{provider} 格式。提供程序必须是发出此调用的服务账号所属的 Google Cloud 项目的项目 ID（例如 sample-cloud-project）。

object (RequestHeader)

标准的 Fleet Engine 请求标头。

integer

要返回的车辆数量上限。默认值：100。

string

上次调用 vehicles.list 提供的 nextPageToken 的值，以便您按页浏览车辆组。如果请求的过滤条件与上次调用 vehicles.list 的过滤条件不同，则此值为未定义。

integer

指定车辆所需的最小载客量。返回的所有车辆的 maximumCapacity 都将大于或等于此值。如果设置，必须大于或等于 0。

enum (TripType)

将响应限制为至少支持一种指定行程类型的车辆。

string (Duration format)

将响应限制为在指定时长内向 Fleet Engine 发送位置信息更新的车辆。仍在传输位置信息的静态车辆不会被视为已过时。如果存在，必须为有效的正时长。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

enum (Category)

必需。将响应限制为与指定类型类别之一相符的车辆。不允许UNKNOWN。

string

调用方可以使用 requiredAttributes、requiredOneOfAttributes 和 requiredOneOfAttributeSets 字段的任意组合来构成复杂的逻辑运算。

requiredAttributes 是一个列表；requiredOneOfAttributes 使用允许列出列表的消息。结合使用这两个字段可组合此表达式：

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

将响应限制为具有指定属性的车辆。此字段是结合/AND 运算。最多允许 50 个 requiredAttributes。这与车辆允许的属性数量上限一致。每个重复的字符串都应采用“key:value”格式。

string

将响应限制为包含每个 VehicleAttributeList 中至少一个指定属性的车辆。在每个列表中，车辆必须至少与其中一个属性匹配。此字段是每个 VehicleAttributeList 中的包含性析取/或运算，也是 VehicleAttributeList 集合中的联接/与运算。每个重复字符串应采用“key1:value1|key2:value2|key3:value3”格式。

string

requiredOneOfAttributeSets 提供其他功能。

与 requiredOneOfAttributes 类似，requiredOneOfAttributeSets 使用允许列表列表的消息，允许使用如下表达式：

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

将响应限制为与 VehicleAttributeList 中的所有属性都匹配的车辆。在每个列表中，车辆必须与所有属性匹配。此字段是每个 VehicleAttributeList 中的合取/AND 运算，也是 VehicleAttributeList 集合中的包含析取/或运算。每个重复的字符串都应采用以下格式："key1:value1|key2:value2|key3:value3"。

enum (VehicleState)

将响应限制为具有此车辆状态的车辆。

boolean

仅归还当前行程的车辆。

string

可选。列出车辆时要应用的过滤查询。如需查看过滤器语法示例，请访问 http://aip.dev/160。

此字段旨在替换 requiredAttributes、requiredOneOfAttributes 和 required_one_of_attributes_sets 字段。如果在此处指定了非空值，则以下字段必须为空：requiredAttributes、requiredOneOfAttributes 和 required_one_of_attributes_sets。

此过滤条件充当具有其他约束条件（例如 vehicleState 或 onTripOnly）的 AND 子句。

请注意，仅支持针对车辆属性（例如 attributes.<key> = <value> 或 attributes.<key1> = <value1> AND attributes.<key2> = <value2>）的查询。过滤条件查询中允许的限制数量上限为 50 个。

此外，所有属性均存储为字符串，因此唯一支持的属性比较是字符串比较。若要与数字或布尔值进行比较，必须明确用英文引号将这些值括起来，才能被视为字符串（例如 attributes.<key> = "10" 或 attributes.<key> = "true"）。

object (Viewport)

可选。一个过滤条件，用于将返回的车辆限制为最近一次已知位置位于视口定义的矩形区域内的车辆。

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

object (LatLng)

必需。视口的低点。

object (LatLng)

必需。视口的高点。