7. 地图打点API
API列表
| 编号 | API名称 | 路径 | 版本 |
|---|---|---|---|
| 7.1 | 新增地图打点 | /v1/iot/emap/add | 1.0 |
| 7.2 | 修改地图打点 | /v1/iot/emap/operations | 1.0 |
| 7.3 | 地图打点分页 | /v1/iot/emap/page | 1.0 |
API调用
7.1: 新增地图打点
描述
请求信息
HTTP协议：HTTP,HTTPS
uri：/v1/iot/emap/add
方法：POST
请求参数
| 名称 | 位置 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| association_id | body | string | y | 点位关联id |
| association_type | body | int | y | 关联类型，1：设备，2：设备房 |
| space_id | body | string | y | 所在的空间id,楼栋，单元，房屋，车场，房屋，设备房之类的id |
| type | body | string | n | 点位类型 |
| x_axes | body | float | y | x轴坐标 |
| y_axes | body | float | y | y轴坐标 |
| project_id | body | string | y | 项目ID |
请求Body描述(非Form表单数据)
{
"x_axes": 0.183536585365854,
"project_id": "21321135",
"y_axes": 0.0950570342205323,
"association_type": 2,
"association_id": "784c4c241e54c56123ce4cb05c31311a",
"type": 1
}
返回信息
返回参数类型
JSON
返回参数
| 名称 | 位置 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| code | 顶层 | STRING | 是 | 响应码标识 |
| message | 顶层 | STRING | 是 | 响应消息文本 |
| data | 顶层 | JSONObject | 是 | 响应数据对象 |
| id | data | String | 是 | 主键ID |
返回结果示例
{
"code": 200,
"data": {
"x_axes": 0.183536585365854,
"create_time": "2020-11-18T03:08:25.416+0000",
"project_id": "21321135",
"update_man": null,
"create_man": null,
"y_axes": 0.0950570342205323,
"association_type": 2,
"id": "20201118110825PJ41VO",
"association_id": "784c4c241e54c56123ce4cb05c31311a",
"type": 1,
"update_date": "2020-11-18T03:08:25.416+0000"
},
"message": "success"
}
7.2: 修改地图打点
描述
请求信息
HTTP协议：HTTP,HTTPS
uri：/v1/iot/emap/operations
方法：POST
请求参数
| 名称 | 位置 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| opt | body | int | y | 操作：1，添加，2：删除，3：更新 |
| association_id | body | string | y | 点位关联id |
| association_type | body | int | y | 关联类型，1：设备，2：设备房 |
| space_id | body | string | y | 所在的空间id,楼栋，单元，房屋，车场，房屋，设备房之类的id |
| type | body | string | n | 点位类型 |
| x_axes | body | float | y | x轴坐标 |
| y_axes | body | float | y | y轴坐标 |
| project_id | body | string | y | 项目ID |
请求Body描述(非Form表单数据)
{
"opt": 1,
"project_id": 610,
"emaps": [
{
"association_id": "156464",
"association_type": "1j16",
"space_id": "3145",
"type": 1,
"x_axes": 0.18353658536585,
"y_axes": 0.18353658536585
},
{
"association_id": "25424",
"association_type": "hh44",
"space_id": "6489",
"type": 1,
"x_axes": 0.18353658536585,
"y_axes": 0.18353658536585
},
{
"association_id": "33344",
"association_type": "htype44",
"space_id": "56464",
"type": 1,
"x_axes": 0.18353658536585,
"y_axes": 0.18353658536585
}
]
}
返回信息
返回参数类型
JSON
返回参数
| 名称 | 位置 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| code | 顶层 | STRING | 是 | 响应码标识 |
| message | 顶层 | STRING | 是 | 响应消息文本 |
| data | 顶层 | JSONObject | 是 | 响应数据对象 |
返回结果示例
{
"code": "200",
"message": "success",
"data": {
}
}
7.3: 地图打点分页列表
描述
请求信息
HTTP协议：HTTP,HTTPS
uri：/v1/iot/emap/page
方法：POST
请求参数
| 名称 | 位置 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| limit | body | int | y | 每页条数 |
| offset | body | int | y | 当前页数 |
| project_id | body | string | y | 项目ID |
请求Body描述(非Form表单数据)
{
"project_id": "610",
"offset": 1,
"limit": 10
}
返回信息
返回参数类型
JSON
返回参数
| 名称 | 位置 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| code | 顶层 | STRING | y | 响应码标识 |
| message | 顶层 | STRING | y | 响应消息文本 |
| data | 顶层 | JSONObject | y | 响应数据对象 |
| count | data | int | y | 总条数 |
| list | data | Array | y | 列表 |
| opt | list | int | y | 操作：1，添加，2：删除，3：更新 |
| association_id | list | string | y | 点位关联id |
| association_type | list | int | y | 关联类型，1：设备，2：设备房 |
| space_id | list | string | y | 所在的空间id,楼栋，单元，房屋，车场，房屋，设备房之类的id |
| type | list | string | y | 点位类型 |
| x_axes | list | float | y | x轴坐标 |
| y_axes | list | float | y | y轴坐标 |
| project_id | list | string | y | 项目ID |
返回结果示例
{
"code": "200",
"message": "success",
"data": {
"count": 10,
"list": [
{
"x_axes": 0.18353658536585366,
"create_time": "2019-11-23T07:13:08.862+0000",
"project_id": "21321135",
"update_man": "120004bb0bd23c00",
"create_man": "120004bb0bd23c00",
"y_axes": 0.09505703422053231,
"id": "20191123151308WVHYHU",
"association_type": 2,
"association_id": "784c4c241e54c56123ce4cb05c31311a",
"type": "",
"space_id": null,
"update_date": "2019-11-23T07:13:08.862+0000"
}
]
}
}