HTTP 数据接口
安装位置列表
接口描述
本接口为安装位置列表接口。
通过调用此接口可以获得设备安装位置与相关信息。
接口调用
-
GET /api/data/placeList HTTP/1.1 Host: dev.thuwater.com X-TH-TOKEN: 26b0e5bfcbc.214ce96c1f7c9f0a33549b81087579b38b6a8.e9ba17523a25d766 -
/api/data/placeList: get: tags: - 安装位置列表 description: 安装位置列表接口 summary: 安装位置列表接口 operationId: placeList parameters: - name: X-TH-TOKEN in: header description: 通过登陆接口获取的token required: true schema: type: string -
var request = require("request"); var options = { method: 'GET', url: 'https://dev.thuwater.com/api/data/placeList', headers: { 'Host': 'dev.thuwater.com', 'X-TH-TOKEN': '26b0e5bfcbc.214ce96c1f7c9f0a33549b81087579b38b6a8.e9ba17523a25d766' } }; request(options, function (error, response, body) { if (error) throw new Error(error); console.log(body); }); -
OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder() .url("https://dev.thuwater.com/api/data/placeList") .get() .addHeader("X-TH-TOKEN", "26b0e5bfcbc.214ce96c1f7c9f0a33549b81087579b38b6a8.e9ba17523a25d766") .addHeader("Host", "dev.thuwater.com") .build(); Response response = client.newCall(request).execute();
调用参数
| 参数名称 | 必填 | 说明 |
|---|---|---|
| X-TH-TOKEN | 是 | 通过登陆接口获取的token |
接口响应
-
HTTP/1.1 200 OK Content-Type: application/json [ { "projectId": "xxxx", // 项目ID "projectName": "yyyy", // 项目名称 "placeId": "xxxx", // 安装点ID "placeName": "xxxx", // 安装点名称 "equipId": "xxxx", // equipId 设备ID "aioEquip": "x", // 是否一体机 0-分体机 1-一体机 "placeAddress": "xxxx", // 详细安装位置 "equipType": "xxxx", // 安装设备类别 "lng": "xxxx", // 安装点经度 "lat": "xxxx", // 安装点纬度 "lngEx": "xxxx", // 安装点经度(扩展) "latEx": "xxxx", // 安装点纬度(扩展) "nodeDepth": "xxxx",// 安装井深,单位(m) "nodeBottomElev": "xxxx",// 安装井井底高程,单位(m) "nodePipeDiameter": "xxxx",// 井内管道直径,单位(mm) "installDepth": "xxxx",// 液位计安装支架顶深,单位(m) "installLineLength": "xxxx",// 液位仪预警探头线长,单位(m) "installOffset": "xxxx"// 液位仪安装距井口距离,单位(m) },{ ..... }, ...... ]
响应参数
| 参数名称 | 说明 |
|---|---|
| httpcode | 200-正常,401-无权限,500-其他错误。 |
| projectId | 项目ID |
| projectName | 项目名称 |
| placeId | 安装点ID |
| placeName | 安装点名称 |
| equipId | 设备ID |
| aioEquip | 是否一体机 0-分体机 1-一体机 |
| placeAddress | 详细安装位置 |
| equipType | 参考 设备数据说明 |
| lng | 安装点经度(高德) 公众雨量计没有经纬度信息 |
| lat | 安装点纬度(高德) 公众雨量计没有经纬度信息 |
| lngEx | 安装点经度(扩展) 默认为WGS84 或者用户另外要求坐标系 |
| latEx | 安装点纬度(扩展) 默认为WGS84 或者用户另外要求坐标系 |
| nodeDepth | 安装井深,单位(m) |
| nodeBottomElev | 安装井井底高程,单位(m) 测量液位和这个值相加就是黄海液位 |
| nodePipeDiameter | 井内管道直径,单位(mm) |
| installDepth | 液位计安装支架顶深,单位(m) |
| installLineLength | 液位仪预警探头线长,单位(m) |
| installOffset | 液位仪安装距井口距离,单位(m) |
| nextConnInterval | 数据上报频率(分钟) |
| warnValue | 预警液位(m) |
| alarmValue | 报警液位(m) |
| outValue | 溢流液位(m) |
| mounted | 是否有安装设备(设备可能被移除,已经测量的数据还是可以获取) |
| latestTime | 最新上报数据时间 |
当无数据的时候返回:[ ]
公众雨量计没有经纬度信息
内容来源于 THWater 官方开发文档查看原文
© 2026 THWater · 北京清环智慧水务科技有限公司