Method: providers.deliveryVehicles.list

获取符合指定过滤条件的所有 DeliveryVehicle

HTTP 请求

GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/deliveryVehicles

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。必须采用 providers/{provider} 格式。provider 必须是 Google Cloud 项目 ID。例如 sample-cloud-project

查询参数

参数
header

object (DeliveryRequestHeader)

可选。标准 Delivery API 请求标头。

pageSize

integer

可选。要返回的车辆数量上限。服务返回的数量可能小于此值。如果您未指定此数量,则服务器将决定要返回的结果数。

pageToken

string

可选。从之前的 deliveryVehicles.list 调用接收的页面令牌。您必须提供此令牌才能检索后续页面。

进行分页时,提供给 deliveryVehicles.list 的所有其他参数必须与提供页面令牌的调用匹配。

filter

string

可选。列出送货车辆时要应用的过滤查询。如需查看过滤器语法示例,请访问 http://aip.dev/160。如果您未指定值,或者为过滤条件指定空字符串,则系统会返回所有配送车辆。

请注意,deliveryVehicles.list 仅支持针对车辆属性(例如 attributes.<key> = <value>attributes.<key1> = <value1> AND attributes.<key2> = <value2>)的查询。此外,所有属性都存储为字符串,因此仅支持对属性进行字符串比较。若要与数字或布尔值进行比较,必须明确用引号括起这些值,以便将其视为字符串(例如 attributes.<key> = "10"attributes.<key> = "true")。

过滤条件查询中允许的限制数量上限为 50。限制是 attribute.<KEY> <COMPARATOR> <VALUE> 形式的查询的一部分,例如 attributes.foo = bar 是 1 个限制。

viewport

object (Viewport)

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

请求正文

请求正文必须为空。

响应正文

deliveryVehicles.list 响应消息。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "deliveryVehicles": [
    {
      object (DeliveryVehicle)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
字段
deliveryVehicles[]

object (DeliveryVehicle)

符合请求的过滤条件的一组配送车辆。如果未指定过滤条件,请求会返回所有配送车辆。成功的响应也可能为空。空响应表示未找到符合请求的过滤条件的送货车辆。

nextPageToken

string

您可以在 ListDeliveryVehiclesRequest 中传递此令牌,以继续列出结果。返回所有结果后,此字段不会出现在响应中,或者将为空字符串。

totalSize

string (int64 format)

所有页面中符合请求条件的配送车辆总数。

视口

纬度-经度视口,表示为两个对角的 lowhigh 点。视口被视为封闭区域,即包含其边界。纬度边界必须介于 -90 度和 90 度(含)之间,经度边界必须介于 -180 度(含)180 度(含)之间。各种情况包括:

  • 如果 low = high,则视口由该单个点组成。

  • 如果 low.longitude > high.longitude,则经度范围会反转(视口跨越 180 度经线)。

  • 如果 low.longitude = -180 度,high.longitude = 180 度,视口将包含所有经度。

  • 如果 low.longitude = 180 度且 high.longitude = -180 度,则经度范围为空。

  • 如果 low.latitude > high.latitude,则纬度范围为空。

必须填充 lowhigh,并且表示的框不能为空(如上文定义所述)。空视口将导致错误。

例如,此视口完全包含纽约市:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON 表示法
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
字段
low

object (LatLng)

必需。视口的最低点。

high

object (LatLng)

必需。视口的高点。