1. 查询邻近的拓扑路网点
获取模型内离给定点最近的N个拓扑点。
请求方式:GET
请求地址:/api/{databaseKey}/routes/nearestPoints?routeKey={routeKey}&start={start}&top={top}&share={share}
1.1. 请求参数
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | 操作的通关令牌 |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
databaseKey | string | test | 是 | 数据库key,必传 |
share | string | NULL | 否 | 分享key 可不指定 |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
routeKey | string | xxx | 是 | 网路key |
start | string | 9830.32,-1354.43,12000.00 | 是 | 起点 |
top | string | 5 | 是 | 最近拓扑点数量 |
Body
application/json:
NULL
1.2. 参数说明
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
1.3. 正确返回
{
"code": "SUCCESS",
"message": "请求处理成功",
"data": [
{
"key": "eb5839b6dc9948e7b1a9a575b6a6473c",
"xyz": [
-13279.0,
-5588.0,
304.0
],
"type": null,
"elevatorNo": null
},
{
"key": "o49bc386da04426abda0293c223795d0",
"xyz": [
-14261.381687242798,
-6626.888888888889,
304.0
],
"type": null,
"elevatorNo": null
}
]
}
1.4. 状态码
状态码 | code | message | data | 原因 |
---|---|---|---|---|
400 | ROUTE_NOT_FINISHED | 路网(xxx)正在提取 | NULL | 当路网正在提取时 |
400 | ROUTE_FAILED | 路网(xxx)提取失败 | NULL | 当路网提取失败时 |
400 | BAD_PARAMETER_TYPE | 参数(top)类型不正确 | NULL | 当top不是数字时 |
400 | BAD_PARAMETER_VALUE | 参数(top)值不正确 | NULL | 当top小于1时 |
1.5. 备注
新版(v2)路网不支持。
1.6. 注意事项
1、参数top应为大于0的整数。
2、根据起点查找拓扑路网中距离最近的指定数量(top)的点;如拓扑点实际数量小于指定值,则返回实际数量。
3、返回拓扑点列表按距离由近到远排序。