返回与请求选项匹配且与提供商相关联的车辆的分页列表。
HTTP 请求
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
parent |
必需。必须采用 |
查询参数
参数 | |
---|---|
header |
标准的 Fleet Engine 请求标头。 |
page |
要返回的车辆数量上限。默认值:100。 |
page |
上次调用 |
minimum |
指定车辆所需的最小载客量。返回的所有车辆的 |
trip |
将响应限制为至少支持一种指定行程类型的车辆。 |
maximum |
将响应限制为在指定时长内向 Fleet Engine 发送位置信息更新的车辆。仍在传输位置信息的静态车辆不会被视为已过时。如果存在,必须为有效的正时长。 该时长以秒为单位,最多包含九个小数位,以“ |
vehicle |
必需。将响应限制为与指定类型类别之一相符的车辆。不允许 |
required |
调用方可以使用
将响应限制为具有指定属性的车辆。此字段是结合/AND 运算。最多允许 50 个 requiredAttributes。这与车辆允许的属性数量上限一致。每个重复的字符串都应采用“key:value”格式。 |
required |
将响应限制为包含每个 |
required |
与
将响应限制为与 |
vehicle |
将响应限制为具有此车辆状态的车辆。 |
on |
仅归还当前行程的车辆。 |
filter |
可选。列出车辆时要应用的过滤查询。如需查看过滤器语法示例,请访问 http://aip.dev/160。 此字段旨在替换 此过滤条件充当具有其他约束条件(例如 请注意,仅支持针对车辆属性(例如 此外,所有属性均存储为字符串,因此唯一支持的属性比较是字符串比较。若要与数字或布尔值进行比较,必须明确用英文引号将这些值括起来,才能被视为字符串(例如 |
viewport |
可选。一个过滤条件,用于将返回的车辆限制为最近一次已知位置位于视口定义的矩形区域内的车辆。 |
请求正文
请求正文必须为空。
响应正文
vehicles.list
响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"vehicles": [
{
object ( |
字段 | |
---|---|
vehicles[] |
与请求中条件匹配的车辆。返回的最大车辆数由请求中的 |
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 |
必需。视口的高点。 |