geo.locations
搜索地理位置
- 请求路由:
geo.locations- 交互模型:
Request Stream- 访问限制: 无
请求
RSocket.rs({
"route" : "geo.locations",
"args" : {
"filter" : {
"targetId" : "vehicle:CN10081013"
},
"pg" : {
"page" : 1,
"size" : 10
}
}
});
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
filter | Object | 否 | 过滤条件 |
filter.traceId | String | 否 | 轨迹标识 |
filter.sw | Number[] | 否 | 地图矩形区域西南角坐标 |
filter.ne | Number[] | 否 | 地图矩形区域东北角坐标 |
filter.targetId | String | 否 | 目标标识 支持正则表达式 |
filter.from | String | 否 | 起始更新时间 |
filter.to | String | 否 | 结束更新时间 |
filter.metadata | Object[] | 否 | 元数据匹配条件,同时匹配所有条目 |
filter.metadata.[].key | String | 否 | |
filter.metadata.[].op | String | 否 | |
filter.metadata.[].value | Varies | 否 | |
filter.metadataAny | Object[] | 否 | 元数据匹配条件,匹配其中任一条目 |
filter.metadataAny.[].key | String | 否 | |
filter.metadataAny.[].op | String | 否 | |
filter.metadataAny.[].value | Varies | 否 | |
pg | Object | 否 | 分页参数 |
pg.page | Number | 否 | 页码,首页从0开始 |
pg.size | Number | 否 | 每页记录,默认为10 |
pg.sort | String[] | 否 | 排序字段清单,默认为升序,需要指定降序时在字段名后面添加desc并用分号隔开。 例如:["id", "crDate;desc"] |
返回
地理位置
[
{
"targetId" : "vehicle:CN10081013",
"tenantId" : "mzd",
"traceId" : "ZXRW202405214084-CN10081013",
"metadata" : {
"duty" : true,
"taskId" : "ZXRW202405214084",
"device" : "Android:Android/sdk_phone_arm64/generic_arm64:8.1.0/OSM1.180201.044.D1/8352955:userdebug/test-keys",
"driverId" : "18900010001@mzd",
"driverName" : "zhang",
"vehicleId" : "CN10081013",
"vehicleNo" : "粤A123(HK123)"
},
"upDate" : "2024-06-04T01:19:24.466594Z"
}
]
返回属性
| 名称 | 类型 | 说明 |
|---|---|---|
id | String | |
point | Object | 位置坐标 6个元素,分别为经度,纬度,海拔,时间戳,速度,方向 |
point.type | String | GeoJSON类型,固定为Point |
point.coordinates | Number[] | 经纬度坐标 一个包含至少2个元素的double数组,第一个和第二个元素为经度和纬度, 其他元素可以是海拔、速度、方向等信息,由具体接口定义 |
traceId | String | 轨迹Id,为空时仅记录位置,不形成轨迹 |
targetId | String | 平台目标标识 URN格式,例如: vehicle:CN10081102, driver:18900010001@mzd |
metadata | Object | 其他用于检索的元数据 |
upDate | String | 最后修改时间 |
crData | String | 创建时间 |
new | Boolean |