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 都必须填充,并且表示的框不得为空(如上述定义所指定)。视口为空会导致错误。

例如,以下视口将纽约市完全包围:

{ &quot;low&quot;: { &quot;latitude&quot;: 40.477398, &quot;longitude&quot;: -74.259087 }, &quot;high&quot;: { &quot;latitude&quot;: 40.91618, &quot;longitude&quot;: -73.70018 } }

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

object (LatLng)

必需。视口的低点。

high

object (LatLng)

必需。视口的高点。