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