获取符合指定过滤条件的所有 DeliveryVehicle
。
HTTP 请求
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/deliveryVehicles
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
parent |
必需。必须采用 |
查询参数
参数 | |
---|---|
header |
可选。标准 Delivery API 请求标头。 |
page |
可选。要返回的车辆数量上限。服务返回的数量可能小于此值。如果您未指定此数量,则服务器将决定要返回的结果数。 |
page |
可选。从之前的 进行分页时,提供给 |
filter |
可选。列出送货车辆时要应用的过滤查询。如需查看过滤器语法示例,请访问 http://aip.dev/160。如果您未指定值,或者为过滤条件指定空字符串,则系统会返回所有配送车辆。 请注意, 过滤条件查询中允许的限制数量上限为 50。限制是 |
viewport |
可选。一个过滤条件,用于将返回的车辆限制为最近一次已知位置位于视口定义的矩形区域内的车辆。 |
请求正文
请求正文必须为空。
响应正文
deliveryVehicles.list
响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"deliveryVehicles": [
{
object ( |
字段 | |
---|---|
delivery |
符合请求的过滤条件的一组配送车辆。如果未指定过滤条件,请求会返回所有配送车辆。成功的响应也可能为空。空响应表示未找到符合请求的过滤条件的送货车辆。 |
next |
您可以在 |
total |
所有页面中符合请求条件的配送车辆总数。 |
视口
纬度-经度视口,表示为两个对角的 low
和 high
点。视口被视为封闭区域,即包含其边界。纬度边界必须介于 -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
,则纬度范围为空。
必须填充 low
和 high
,并且表示的框不能为空(如上文定义所述)。空视口将导致错误。
例如,此视口完全包含纽约市:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
JSON 表示法 |
---|
{ "low": { object ( |
字段 | |
---|---|
low |
必需。视口的最低点。 |
high |
必需。视口的高点。 |