# 空间数据接口
# 1. WID查询坐标
- 功能描述 获取某对象的基本空间信息。
- 请求URL:
/space/geo/object/getByWId
- 请求方式:
GET
- 请求参数
参数名 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,过期需重新登录 |
wId | String | 是 | 非空且长度固定36位 | (空间wid) 对象的唯一标识 |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
/space/geo/object/getByWId
?wId=0007e43d-45d7-44c0-acfc-fc5539b6516a
&token=
2
3
- 返回参数
名称 | 类型 | 说明 | 示范值 | |
code | number | 返回码 | 返回码;0表示成功,非0表示出错 | |
success | Boolean | 错误信息 | 返回信息;true 表示成功,false 表示出错 | |
data | array | 对象数组 | ||
wId | string | 对象的唯一标识 | "0007e43d-45d7-44c0-acfc-fc5539b6516a", | |
poiId | string | POI编号 | "4403002230221018_9", | |
name | string | 设备名称 | "蓝牙ibeacon", | |
boothId | string | 现场编号 | "", | |
level | number | 对象所属层级 | 9, | |
longitude | number | 经度 | 113.935327719, | |
latitude | number | 纬度 | 22.522594372, | |
height | number | 绝对高度 | 86.45, | |
poiCode | string | 分类编码 | "w0907015", | |
sn | string | 设备SN实际编码 | "1918FC0636A0", | |
positionText | string | 位置描述 | "腾讯滨海大厦滨海南塔F18" |
- 返回示例
{
"code": 0,
"data": {
"wId": "0007e43d-45d7-44c0-acfc-fc5539b6516a",
"poiId": "4403002230221018_9",
"name": "蓝牙ibeacon",
"boothId": "",
"level": 9,
"longitude": 113.935327719,
"latitude": 22.522594372,
"height": 86.45,
"poiCode": "w0907015",
"sn": "1918FC0636A0",
"positionText": "腾讯滨海大厦_滨海南塔_F18"
},
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 2. 坐标查询WID
- 功能描述
获取包含指定坐标位置和指定父级空间对象的空间对象列表,如已知某设备对象的坐标和设备所在楼层,查询空间范围上包含该设备的自定义区域等。
- 请求URL:
/space/geo/getObjectsContainLocation
- 请求方式:
GET
- 请求参数
参数名 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
location | String | 是 | 非空 | 坐标位置,经纬度,格式:“纬度,经度”,如22.522646,113.935486 |
parentPoiId | String | 是 | 非空 | 父级对象的空间id ,如滨海大厦 '440300223022' |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
/space/geo/getObjectsContainLocation
?location=22.522646%2C113.935486
&parentPoiId=44030022
&token=
2
3
4
- 返回参数
名称 | 类型 | 说明 | 示范值 | |
code | number | 返回码 | 返回码;0表示成功,非0表示出错 | |
success | Boolean | 错误信息 | 返回信息;true 表示成功,false 表示出错 | |
data | array | 对象数组 | ||
wId | string | 对象的唯一标识 | "638d5b0a-744d-4643-a7a6-cfc489875105", | |
poiId | string | POI编号 | "4403002230221007", | |
name | string | 设备名称 | "F7", | |
level | number | 对象所属层级 | 7, | |
longitude | number | 经度 | 113.935327719, | |
latitude | number | 纬度 | 22.522594372, | |
height | number | 绝对高度 | 35, | |
poiCode | string | 分类编码 | " m99999000", | |
positionText | string | 位置描述 | "腾讯滨海大厦_F7" |
- 返回示例
{
"code": 0,
"data": [
{
"wId": "638d5b0a-744d-4643-a7a6-cfc489875105",
"poiId": "4403002230221007",
"name": "F7",
"level": 7,
"longitude": 113.93536231722,
"latitude": 22.5228742683381,
"height": 35,
"poiCode": "m99999000",
"positionText": "腾讯滨海大厦_F7"
}
],
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 3. WID查询父级包含位置信息
- 功能描述
通过WID查询对象的父级空间包含关系及位置信息。例如:某个智能设备level9,查询此设备所处的level8房间名、level7楼层、level6建筑名等。
- 请求URL:
/space/geo/object/getLocationByWId
- 请求方式:
GET
- 请求参数
参数名 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空长度固定128位 | 动态密钥,有效期20分钟,需重新登录 |
wId | String | 是 | 非空长度固定36位 | (空间wid) 对象的唯一标识 |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
/space/geo/object/getLocationByWId
?wId=00019062-f1bd-4538-b5bf-14030ce7970d
&token=
2
3
返回参数
名称 类型 说明 示范值 code number 返回码 返回码;0表示成功,非0表示出错 success Boolean 错误信息 返回信息;true 表示成功,false 表示出错 data array 对象数组 wId string 对象的唯一标识 "0007e43d-45d7-44c0-acfc-fc5539b6516a", poiId string POI编号 "4403002230221018_9", name string 设备名称 "蓝牙ibeacon", level number 对象所属层级 9, longitude number 经度 113.935327719, latitude number 纬度 22.522594372, height number 绝对高度 86.45, poiCode string 分类编码 "w0907015", positionText string 位置描述 "腾讯滨海大厦_滨海南塔_F18" location array 数组(父级别) wId string 对象的唯一标识 poiId string POI编号 name string 设备名称 level number 对象所属层级 longitude number 经度 latitude number 纬度 height number 绝对高度 poiCode string 分类编码 positionText string 位置描述 返回示例
{
"code": 0,
"data": {
"wId": "00019062-f1bd-4538-b5bf-14030ce7970d",
"poiId": "44030022302210280510308",
"name": "工位",
"level": 8,
"longitude": 113.935115841964,
"latitude": 22.5230798095138,
"height": 128.9,
"poiCode": "m00403000",
"positionText": "腾讯滨海大厦_F28_工位",
"location": [
{
"wId": "a66348f2-0700-1000-abcd-35269c4636aa",
"poiId": "440300223022",
"name": "腾讯滨海大厦",
"level": 6,
"longitude": 113.935131878688,
"latitude": 22.52347513938,
"height": -6.3
},
{
"wId": "e0ace2f8-3823-4acc-989a-4db7bcf35f54",
"poiId": "4403002230221028",
"name": "F28",
"level": 7,
"longitude": 113.93536231722,
"latitude": 22.5228742683381,
"height": 128.9,
"poiCode": "m99999000",
"positionText": "腾讯滨海大厦_F28"
}
]
},
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# 4. 批量查询对象
- 功能描述
批量返回某个建筑范围内的所有父子对象列表,如:已知某建筑wId(level6),查询本建筑的所有楼层(level7)、某层楼的所有房间(level8)等。关于不同层级对象的 POIID 与 Level 定义,见“名词解释”中 POIID 的介绍。
- 请求URL:
/space/geo/object/getSubObjects
- 请求方式:
GET
- 请求参数
参数名 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
wId | String | 是 | 非空且长度固定36位 | 对象的唯一标识,例如填入大厦wid或者楼层wid |
poiCode | String | 是 | 不超过64个字符 | 分类编码,详见2.2.9查询分类编码接口, 例如:洗手间m00201、车位号m00500000、照明灯具w0107006 |
level | String | 是 | 7(楼层)、8(房间)、9(设备点) | |
offset | int | 是 | 偏移量,默认为0 | |
limit | int | 是 | ||
name | String | 否 | ||
boothId | String | 否 | 图纸编号 精确值 | |
boothIdText | String | 否 | 图纸编号 文本匹配模糊查询 | |
srid | String | 否 | 默认值为4326 | |
dinNotEmpty | Boolean | 否 | 默认值为False | |
project_id | String | 否 | 非空 | 项目编号 |
备注: 1.offset和limit为自主分页请求参数,若数据量(返回结果中的totalRow)超过接口limit最大限制,建议偏移offset获取数据 2.limit最大限制2万条。当请求超过2千条时,接口将出现warn提示
- 请求示例
/space/geo/object/getSubObjects
?level=8
&offset=0
&limit=2
&wId=a66348f2-0700-1000-abcd-35269c4636aa
&poiCode=m
&token=
&name=
&srid=
&dinNotEmpty=
2
3
4
5
6
7
8
9
10
返回参数
名称 类型 描述 code String 0表示成功,非0表示出错 success Boolean true 表示成功,false 表示出错 data array 对象数组 wId String 对象的唯一标识,例如填入大厦wid或者楼层wid poiId String poiID见继承规则 Name String 名称 Level Number 7(楼层)、8(房间)、9(设备点) Longitude Number 经度, Latitude Number 纬度, Height Number 高度,相对高度,非绝对海拔 PoiCode String 分类编码,详见查询分类编码接口,例如:洗手间m00201、车位号m00500000、照明灯具w0107006 totalRow Number 返回数量 返回示例
{
"code": 0,
"data": {
"features": [
{
"level": 7,
"latitude": 22.523381873802,
"wId": "bae86426-d9b5-43ed-9e94-3e7238d7b83b",
"name": "F31",
"poiId": "4403002230221031",
"poiCode": "m99999000",
"height": 141.95,
"longitude": 113.935474696462
}
],
"totalRow": 12
},
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 5. 批量查询地理对象
- 功能描述
批量返回某个空间范围内的所有对象列表,如:某栋建筑的所有楼层(level7)、某层楼的所有房间(level8)、某个房间内的某种设备(level9)等。
- 请求URL:
/space/geo/object/getGeoSubObjects
- 请求方式:
GET
- 请求参数
参数名 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
wId | String | 是 | 非空且长度固定36位 | 对象的唯一标识,例如填入大厦wid或者楼层wid |
poiCode | String | 是 | 不超过64个字符 | 分类编码,详见2.2.9查询分类编码接口, 例如:洗手间m00201、车位号m00500000、照明灯具w0107006 |
level | String | 是 | 7(楼层)、8(房间)、9(设备点) | |
offset | int | 是 | 偏移量,默认为0 (从第0条记录开始获取) | |
limit | int | 是 | 记录限制,默认50 | |
name | String | 否 | ||
project_id | String | 否 | 非空 | 项目编号 |
备注: 1.offset和limit为自主分页请求参数,若数据量(返回结果中的totalRow)超过接口limit最大限制,建议偏移offset获取数据 2.limit最大限制2万条。当请求超过2千条时,接口将出现warn提示
- 请求示例
/space/geo/object/getGeoSubObjects
?poiCode=m99
&level=7
&name=F7
&token=
&wId=a66348f2-0700-1000-abcd-35269c4636aa
2
3
4
5
6
返回参数
名称 类型 说明 示范值 code number 返回码 返回码;0表示成功,非0表示出错 success Boolean 错误信息 返回信息;true 表示成功,false 表示出错 data array 对象数组 totalRow number type string features array geometry array 空间对象 coordinates array 对象坐标串 如果是面第一个点与最后一个点相同 longitude,Latitude Number 经度,纬度 点1 longitude,Latitude Number 经度,纬度 点N type string 空间对象的几何类型 例如:复合多线'MultiLineString', 多边形'Polygon',复合多边形 'MultiPolygon', id string 对象的唯一标识 type string 类型 properties array 数组(属性) wId string 对象的唯一标识 poiId string POI编号 name string 设备名称 level number 对象所属层级 longitude number 经度 latitude number 纬度 height number 绝对高度 poiCode string 分类编码 positionText string 位置描述 返回示例
{
"code": 0,
"data": {
"features": [
{
"geometry": {
"coordinates": [
[
[
[
113.935474696462,
22.523381873802
],
[
113.935487513624,
22.5233446500345
]
]
]
],
"type": "MultiPolygon"
},
"id": "bae86426-d9b5-43ed-9e94-3e7238d7b83b",
"type": "Feature",
"properties": {
"gid": 18196,
"level": 7,
"latitude": 22.523381873802,
"wId": "bae86426-d9b5-43ed-9e94-3e7238d7b83b",
"name": "F31",
"poiId": "4403002230221031",
"poiCode": "m99999000",
"height": 141.95,
"longitude": 113.935474696462
}
}
],
"type": "FeatureCollection"
},
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# 6. 保存/编辑自定义边界
- 功能描述
保存或者编辑自定义边界对象。
- 请求URL:
/space/geo/saveMetaArea
- 请求方式:
POST
- 请求参数
参数名 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
https://api.weiling.qq.com/space/geo/saveMetaArea?token=
- 请求包体
格式: application/json
中心点模式的自定义边界:
{
"name": "测试123",
"level": 8,
"height": -6.3,
"poiCode": 99901000,
"extMetaArea": {
"parentPoiId": "4403002230220001",
"mode": "point",
"center": {
"longitude": 113.935250639562,
"latitude": 22.522482718566
},
"radius": 400
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
多边形模式的自定义边界:
{
"wId": "1db2977f-466c-4dae-95f0-83624e4d4c6d",
"name": "测试1234",
"level": 8,
"height": -6.3,
"extMetaArea": {
"parentPoiId": "4403002230220001",
"mode": "polygon",
"points": [
{
"longitude": 113.935250639562,
"latitude": 22.522482718566
},
{
"longitude": 113.935250639562,
"latitude": 22.622482718566
},
{
"longitude": 113.965250639562,
"latitude": 22.622482718566
},
{
"longitude": 113.965250639562,
"latitude": 22.522482718566
}
]
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
- 包体参数
参数名 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
wId | String | 否 | 长度固定36位 | 对象的唯一标识;若有 wId,表示更新;若无wId,表示新增 |
level | Integer | 是 | 数字,范围1-9 | 自定义空间对象所在空间层级 |
poiCode | String | 是 | 非空 | 自定义空间对象的空间分类编码 |
parentPoiId | String | 是 | 非空 | 自定义空间对象的父级对象的 PoiId |
mode | String | 是 | 非空,point 或 polygon | 自定义空间的模式;point 表示中心点模式,使用中心点和半径表示;polygon 表示多边形模式,使用多个顺序点表示 |
center | Object | 否 | 当mode为 point时为必须 | 中心点模式的自定义边界对象的中心点坐标,经纬度 |
radius | Number | 否 | 当 mode 为 point 时为必须 | 中心点模式的自定义边界对象的半径,单位米 |
points | List | 否 | 当mode为 polygon时必须 | 多边形模式的自定义边界对象的各点坐标,经纬度;注意顺序有关 |
返回参数
名称 类型 说明 示范值 code number 返回码 返回码;0表示成功,非0表示出错 success Boolean 错误信息 返回信息;true 表示成功,false 表示出错 data array 对象数组 wId string 对象的唯一标识 "0007e43d-45d7-44c0-acfc-fc5539b6516a", poiId string POI编号 "4403002230221018_9", name string 设备名称 "蓝牙ibeacon", level number 对象所属层级 9, longitude number 经度 113.935327719, latitude number 纬度 22.522594372, height number 绝对高度 86.45, poiCode string 分类编码 "w0907015", extMetaArea array 数组 自定义区域边界 parentPoiId array 父级别POI编号 radius string 对象的唯一标识 中心点模式的自定义边界对象的半径,单位米 points array 坐标串数组 多边形模式的自定义边界对象的各点坐标,经纬度;注意顺序有关 longitude number 经度 latitude number 纬度 mode string 自定义空间的模式 例如:多边形'Polygon' 返回示例
{
"code": 0,
"data": {
"wId": "c11e6aed-8033-44c7-8113-b5af0816fd8e",
"poiId": "4403002230220001_ma",
"level": 8,
"longitude": 113.950250639562,
"latitude": 22.572482718566,
"height": -6.3,
"extMetaArea": {
"parentPoiId": "4403002230220001",
"radius": 0,
"points": [
{
"latitude": 22.522482718566,
"longitude": 113.935250639562
},
{
"latitude": 22.622482718566,
"longitude": 113.935250639562
},
{
"latitude": 22.622482718566,
"longitude": 113.965250639562
},
{
"latitude": 22.522482718566,
"longitude": 113.965250639562
}
],
"mode": "polygon"
}
},
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# 7. 查询POICODE分类编码
- 功能描述
查询分类编码(即 PoiCode)。
- 请求URL:
/space/geo/getCatalog
- 请求方式:
GET
- 请求参数
参数名 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
projectId | Integer | 是 | Int32 | 项目id,如11 |
page | Integer | 是 | Int32 | 页码,第一页为page为1 |
count | Integer | 是 | 不超过100 | 一页的条目数目 |
poiCode | String | 是 | 不超过64个字符 | 空间对象的poiCode分类编码,例如:w02或m02 |
- 请求示例
/space/geo/getCatalog
?projectId=11
&page=1
&count=10
&poiCode= w0701003
&token=
2
3
4
5
6
返回参数
名称 类型 说明 示范值 code String 0表示成功,非0表示出错 success Boolean 错误信息 返回信息;true 表示成功,false 表示出错 data array 数组 List array 数组 Id number 分类编码表顺序 Name String 名称 Level number 分类编码等级 ParentId number 上一级id号 ProjectId number 项目编号 isAssets Boolean 是否资产 true 为真,false 为否 PoiCode String 分类编码 例如:洗手间m00201、车位号m00500000、照明灯具w0107006 pageNumber number 当前页码 pageSize number 页行数 totalPage number 总页数 totalRow number 返回数量 返回示例
{
"code": 0,
"data": {
"list": [
{
"id": 4886,
"name": "服务设施-未分类",
"level": 2,
"parentId": 1,
"projectId": 11,
"isAssets": false,
"poiCode": "m00200"
},
{
"id": 4888,
"name": "卫生间",
"level": 2,
"parentId": 4886,
"projectId": 11,
"isAssets": false,
"poiCode": "m00201"
},
{
"id": 4894,
"name": "便民设施",
"level": 2,
"parentId": 4888,
"projectId": 11,
"isAssets": false,
"poiCode": "m00202"
}
],
"pageNumber": 1,
"pageSize": 10,
"totalPage": 2,
"totalRow": 12
},
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# 8. DIN查询设备信息
- 功能描述
用DIN查询对象地理信息。
- 请求URL:
/space/inner/device/getDeviceByDeviceId
- 请求方式:
GET
- 请求参数
参数名 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
din | String | 是 | 通常为18位数字 | 设备在微瓴的唯一标识 |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
/space/inner/device/getDeviceByDeviceId
?din=144115194541786483
&token=
2
3
返回参数
名称 类型 描述 code String 返回码;0表示成功,非0表示出错 success Boolean 返回信息;true 表示成功,false 表示出错 data array 数组 wid String 对象的唯一标识,例如填入大厦wid或者楼层wid poiId String Poi编号 boothId string 现场编号 name String 名称 level number 层级关系: 例如7(楼层)、8(房间)、9(设备点) longitude number 经度 latitude number 纬度 height number 高度 poiCode String 分类编码,详见查询分类编码接口,例如:洗手间m00201、车位号m00500000、照明灯具w0107006 sn String 厂家编号 din String 物联设备唯一标识,可以是物联网关 subID String 子设备id,同一个物联网关可级联多个子设备,通过子设备id实现独立控制 positionText String 位置描述信息 返回示例
{
"code": 0,
"data": {
"wId": "c25f5978-27e5-45be-8b49-dc4ce6e0b857",
"poiId": "44030022302210250200047_9",
"name": "优图盒子",
"boothId": "北门_2501",
"level": 9,
"longitude": 113.935307547835,
"latitude": 22.5231118649662,
"height": 115.7,
"poiCode": "w0713002",
"sn": "52E8DFBD562D41a0",
"din": "144115194541786483",
"subId": "",
"positionText": "滨海大厦_北塔_25F_西梯-北门_2501"
},
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 9. DIN查询信息及设备父级地理包含关系
- 功能描述
用DIN查询对象地理信息。
- 请求URL:
/space/geo/object/getLocationByDin
- 请求方式:
GET
- 请求参数
参数名 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
din | String | 是 | 设备在微瓴的唯一标识 | |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
/space/geo/object/getLocationByDin
?din=144115194541786483
&token=
2
3
返回参数
名称 类型 说明 示范值 code number 返回码 返回码;0表示成功,非0表示出错 success Boolean 错误信息 返回信息;true 表示成功,false 表示出错 data array 对象数组 wId string 对象的唯一标识 "0007e43d-45d7-44c0-acfc-fc5539b6516a", poiId string POI编号 "4403002230221018_9", name string 设备名称 "蓝牙ibeacon", boothId string 现场编号 level number 对象所属层级 9, longitude number 经度 113.935327719, latitude number 纬度 22.522594372, height number 绝对高度 86.45, poiCode string 分类编码 "w0907015", sn String 厂家编号 din String 物联设备唯一标识,可以是物联网关 subID String 子设备id,同一个物联网关可级联多个子设备,通过子设备id实现独立控制 positionText string 位置描述 "腾讯滨海大厦_滨海南塔_F18" location array 数组(父级别) wId string 对象的唯一标识 poiId string POI编号 name string 设备名称 level number 对象所属层级 longitude number 经度gcj20 latitude number 纬度 height number 绝对高度 返回示例
{
"code": 0,
"data": {
"wId": "c25f5978-27e5-45be-8b49-dc4ce6e0b857",
"poiId": "44030022302210250200047_9",
"name": "优图盒子",
"boothId": "北门_2501",
"level": 9,
"longitude": 113.935307547835,
"latitude": 22.5231118649662,
"height": 115.7,
"poiCode": "w0713002",
"sn": "52E8DFBD562D41a0",
"din": "144115194541786483",
"subId": "",
"positionText": "腾讯滨海大厦_滨海北塔_25F_西梯-北门_2501",
"location": [
{
"wId": "a66348f2-0700-1000-abcd-35269c4636aa",
"poiId": "440300223022",
"name": "腾讯滨海大厦",
"level": 6,
"longitude": 113.935131878688,
"latitude": 22.52347513938,
"height": -6.3
},
{
"wId": "fcbd41c0-dc95-46f8-9616-68e8b96f8c3d",
"poiId": "44030022302210250200047",
"name": "辅助分区(业务上无意义)",
"level": 8,
"longitude": 113.935337645889,
"latitude": 22.5230878195398,
"height": 115.7,
"poiCode": "m99901000",
"positionText": "腾讯滨海大厦_F25_辅助分区(业务上无意义)"
},
{
"wId": "6a1dcf46-f51f-4e39-893f-744d0220f70a",
"poiId": "4403002230221025",
"name": "F25",
"level": 7,
"longitude": 113.935356522636,
"latitude": 22.5228336837518,
"height": 115.7,
"poiCode": "m99999000",
"positionText": "腾讯滨海大厦_F25"
}
]
},
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
# 10. DIN查询周围设备信息
- 功能描述
用DIN,PoiCode查询对象地理信息。
- 请求URL:
space/geo/object/listNearbyObjectsByDin
- 请求方式:
GET
- 请求参数
名称 | 类型 | 说明 |
---|---|---|
scopeRadius | number | 搜索半径,单位米 |
scopeLevel | number | 搜索空间范围层级,大于0的整数,其中: 1.同个项目 -(不含该字段或值为 null 或为 0) 2.同个建筑 - 6 3.同一楼层 - 7 4.同一房间/位置区域 - 8 |
objectLevel | number | 表示要搜索的目标的层级,固定为 9,即设备层级 |
objectPoiCode | String | 表示要搜索的目标的 PoiCode,需在管理平台处从字典表中获取 productId 对应的 PoiCode |
limit | number | 查询结果限制,最多 200 个,若不设置,默认为 20 个 |
offset | number | 偏移量, 可以不传这个参数,默认是 0 |
project_id | String | 项目编号 |
- 请求示例
/space/geo/object/listNearbyObjectsByDin?
din=300000000000011111
&scopeRadius=50
&scopeLevel=7
&objectLevel=9
&objectPoiCode=w0701005
&offset=0
&limit=3
&token=****************************
2
3
4
5
6
7
8
9
返回参数
名称 类型 说明 示范值 code number 返回码 返回码;0表示成功,非0表示出错 success Boolean 错误信息 返回信息;true 表示成功,false 表示出错 data array 对象数组 wId string 对象的唯一标识 "61138b73-d610-4a07-86e5-799667ec02c8", poiId string POI编号 "4403002230221018_9", name string 设备名称 "1F 3号楼梯室外出入口摄像头", boothId string 现场编号 level number 对象所属层级 2, longitude number 经度 121.37603134392273, latitude number 纬度 31.27399460631333, height number 绝对高度 2, poiCode string 分类编码 "w0701005", sn String 厂家编号 din String 物联设备唯一标识,可以是物联网关 positionText string 位置描述 "英雄商办楼_F1_C070" distance number 距离,数组按从小到大排序;单位:米 "1.263541036" 返回示例
{
"code": 0,
"data": [
{
"wId": "61138b73-d610-4a07-86e5-799667ec02c8",
"poiId": "310107000000100100037_9",
"name": "1F 3号楼梯室外出入口",
"boothId": "C070",
"level": 9,
"longitude": 121.37603134392273,
"latitude": 31.27399460631333,
"height": 2.0,
"poiCode": "w0701005",
"sn": "iDS-2PT7D28SLW-SH20190910AACHD60871251X",
"din": "300000000000010175",
"positionText": "英雄商办楼_F1_C070",
"distance": 1.263541036
},
{
"wId": "377643db-7b66-4b0a-9cd3-6e59a39434fb",
"poiId": "310107000000100100037_9",
"name": "1F 3号楼梯室外出入口",
"boothId": "C070",
"level": 9,
"longitude": 121.37603134392273,
"latitude": 31.27399460631333,
"height": 2.0,
"poiCode": "w0701005",
"sn": "iDS-2PT7D28SLW-SH20190910AACHD60871251X",
"din": "300000000000010175",
"positionText": "英雄商办楼_F1_C070",
"distance": 1.263541036
},
{
"wId": "7054a5fb-7df8-40c5-bceb-67ec26d40acc",
"poiId": "3101070000001001_9",
"name": "1F VIP电梯厅",
"boothId": "C067",
"level": 9,
"longitude": 121.37603027191103,
"latitude": 31.27400091213877,
"height": 2.0,
"poiCode": "w0701005",
"sn": "iDS-2PT7D28SLW-SH20190910AACHD60871257X",
"din": "300000000000010172",
"positionText": "英雄商办楼_F1_C067",
"distance": 1.92689158
}
],
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
# 11. 根据din获取设备
- 功能描述
获取指定din和subId所对应的地理对象,subId传空代表没有subId
- 请求URL:
space/geo/object/getByDin
- 请求方式:
GET
- 请求参数
名称 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
din | String | 是 | 非空 | 设备在微瓴的唯一标识 |
subId | String | 否 | 非空 | 旧子ID,没有可不传 |
project_id | String | 是 | 非空 | 项目编号 |
- 请求示例
/space/geo/object/getByDin?
din=144115194540213736&
token=****************************
2
3
返回参数
名称 类型 说明 示范值 code number 返回码 返回码;0表示成功,非0表示出错 success Boolean 错误信息 返回信息;true 表示成功,false 表示出错 data json 对象数组 wId string 对象的唯一标识 "0007e43d-45d7-44c0-acfc-fc5539b6516a", poiId string POI编号 "4403002230221018_9", name string 设备名称 "蓝牙ibeacon", level number 对象所属层级 9, longitude number 经度 113.935327719, latitude number 纬度 22.522594372, height number 绝对高度 86.45, poiCode string 分类编码 "w0907015", positionText string 位置描述 "腾讯滨海大厦_滨海南塔_F18" 返回示例
{
"code": 0,
"data": {
"wId": "48a521dd-0fb6-4687-99a4-fe28ca05f50c",
"poiId": "4403002230220003_9",
"name": "网关",
"boothId": "C-010",
"level": 9,
"longitude": 113.934889707,
"latitude": 22.522769728,
"height": -15.7,
"poiCode": "w0107006",
"sn": "009569AEE98C0000",
"din": "144115194540213736",
"subId": "",
"positionText": "腾讯滨海大厦_地下室_B3_地下负三层"
},
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 12. 获取指定din和subId所对应的地理对象
- 功能描述
获取指定din和subId所对应的地理对象,subId传空代表父子都返回
- 请求URL:
/space/geo/object/getGeoObjectsByDinAndSubId
- 请求方式:
GET
- 请求参数
名称 | 类型 | 是否必传 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
din | String | 是 | 非空 | 设备在微瓴的唯一标识 |
subId | String | 否 | 非空 | 旧子ID,没有可不传 |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
/space/geo/object/getGeoObjectsByDinAndSubId?
din=144115194540213736&
token=****************************
2
3
返回参数
名称 类型 说明 示范值 code number 返回码 返回码;0表示成功,非0表示出错 success Boolean 错误信息 返回信息;true 表示成功,false 表示出错 data array 对象数组 wId string 对象的唯一标识 "0007e43d-45d7-44c0-acfc-fc5539b6516a", poiId string POI编号 "4403002230221018_9", name string 设备名称 "蓝牙ibeacon", level number 对象所属层级 9, longitude number 经度 113.935327719, latitude number 纬度 22.522594372, height number 绝对高度 86.45, poiCode string 分类编码 "w0907015", positionText string 位置描述 "腾讯滨海大厦_滨海南塔_F18" 返回示例
{
"code": 0,
"data": [
{
"wId": "2070ca60-a19b-4113-b00a-e0b9c0c9d269",
"poiId": "4403002230220003_9",
"name": "计量灯控模块",
"boothId": "L-0287",
"level": 9,
"longitude": 113.934841972,
"latitude": 22.522797738,
"height": -15.7,
"poiCode": "w0107007",
"sn": "009569AEE98C0000",
"din": "144115194540213736",
"subId": "00124B000FF39D4D",
"cadFloor": "B3",
"positionText": "腾讯滨海大厦_地下室_B3_地下负三层",
"assetExtension": {},
"innerHeight": 0
},
{
"wId": "3b89e67e-51dd-4013-8ea6-990d7269d67c",
"poiId": "4403002230220003_9",
"name": "计量灯控模块",
"boothId": "L-0241",
"level": 9,
"longitude": 113.93488686,
"latitude": 22.52272158,
"height": -15.7,
"poiCode": "w0107007",
"sn": "009569AEE98C0000",
"din": "144115194540213736",
"subId": "00124B000FF3C588",
"cadFloor": "B3",
"positionText": "腾讯滨海大厦_地下室_B3_地下负三层",
"assetExtension": {},
"innerHeight": 0
},
{
"wId": "48a521dd-0fb6-4687-99a4-fe28ca05f50c",
"poiId": "4403002230220003_9",
"name": "网关",
"boothId": "C-010",
"level": 9,
"longitude": 113.934889707,
"latitude": 22.522769728,
"height": -15.7,
"poiCode": "w0107006",
"sn": "009569AEE98C0000",
"din": "144115194540213736",
"subId": "",
"cadFloor": "B3",
"positionText": "腾讯滨海大厦_地下室_B3_地下负三层",
"assetExtension": {},
"innerHeight": 0
}
],
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
# 13. wids列出对象
- 功能描述
列出wid列表出所对应的 不含geojson的地理对象
- 请求URL:
/space/geo/object/listByWIds
- 请求方式:
GET
- 请求参数
名称 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
wIds | String | 是 | 非空 | 设备标识 |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
/space/geo/object/listByWIds?
wIds=291b568a-a0cb-4c29-9af0-5097a5a049b9,a66348f2-0700-1000-abcd-35269c4636aa&
token=****************************
2
3
返回参数
名称 类型 说明 示范值 code number 返回码 返回码;0表示成功,非0表示出错 success Boolean 错误信息 返回信息;true 表示成功,false 表示出错 data array 对象数组 wId string 对象的唯一标识 "0007e43d-45d7-44c0-acfc-fc5539b6516a", poiId string POI编号 "4403002230221018_9", name string 设备名称 "蓝牙ibeacon", level number 对象所属层级 9, longitude number 经度 113.935327719, latitude number 纬度 22.522594372, height number 绝对高度 86.45, poiCode string 分类编码 "w0907015", positionText string 位置描述 "腾讯滨海大厦_滨海南塔_F18" assetExtension jsonObject 拓展信息 {"nickName": "xxxx"} 返回示例
{
"code": 0,
"data": [
{
"wId": "291b568a-a0cb-4c29-9af0-5097a5a049b9",
"poiId": "4403002230221004_9",
"name": "计量灯控模块",
"boothId": "L04-0068",
"level": 9,
"longitude": 113.935254413,
"latitude": 22.523169073,
"height": 17,
"poiCode": "w0107007",
"sn": "00019",
"din": "",
"subId": "01101",
"cadFloor": "F4",
"positionText": "腾讯滨海大厦_滨海北塔_F4_北塔",
"assetExtension": {},
"innerHeight": 0
},
{
"wId": "a66348f2-0700-1000-abcd-35269c4636aa",
"poiId": "440300223022",
"name": "腾讯滨海大厦",
"level": 6,
"longitude": 113.935131878688,
"latitude": 22.52347513938,
"height": -6.3,
"innerHeight": 0
}
],
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# 14. wids列出含geojson对象
- 功能描述
列出wid列表出所对应的 含geojson的地理对象
- 请求URL:
/space/geo/object/listGeoByWIds
- 请求方式:
GET
- 请求参数
名称 | 类型 | 是否必传 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
srid | string | 否 | 非空 | srid,项目projectId使用0 |
wIds | string | 是 | 非空 | 逗号隔开 |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
/space/geo/object/listGeoByWIds?
wIds=291b568a-a0cb-4c29-9af0-5097a5a049b9,a66348f2-0700-1000-abcd-35269c4636aa&
token=****************************
2
3
- 返回示例
{
"code": 0,
"data": {
"features": [
{
"geometry": {
"coordinates": [
12683214.5046572,
2574454.95392706
],
"type": "Point"
},
"id": "291b568a-a0cb-4c29-9af0-5097a5a049b9",
"type": "Feature",
"properties": {
"latitude": 2574454.953927055,
"din": "",
"assetExtension": {},
"poiId": "4403002230221004_9",
"sn": "00019",
"poiCode": "w0107007",
"height": 17,
"longitude": 12683214.504657235,
"innerHeight": 0,
"cadFloor": "F4",
"level": 9,
"boothId": "L04-0068",
"subId": "01101",
"positionText": "腾讯滨海大厦_滨海北塔_F4_北塔",
"wId": "291b568a-a0cb-4c29-9af0-5097a5a049b9",
"name": "计量灯控模块"
}
},
{
"geometry": {
"coordinates": [
[
[
[
12683200.8642,
2574491.8385
],
[
12683215.3626,
2574488.0287
],
[
12683200.8642,
2574491.8385
]
]
]
],
"type": "MultiPolygon"
},
"id": "a66348f2-0700-1000-abcd-35269c4636aa",
"type": "Feature",
"properties": {
"latitude": 2574491.838499899,
"poiId": "440300223022",
"height": -6.3,
"longitude": 12683200.864200018,
"innerHeight": 0,
"level": 6,
"wId": "a66348f2-0700-1000-abcd-35269c4636aa",
"name": "腾讯滨海大厦"
}
}
],
"type": "FeatureCollection"
},
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
# 15. 根据dins列出地理对象
- 功能描述
列出din列表出所对应的 不含geojson的地理对象
- 请求URL:
/space/geo/object/listByDins
- 请求方式:
GET
- 请求参数
名称 | 类型 | 是否必传 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
srid | string | 是 | 非空 | srid,项目projectId使用0 |
dins | string | 是 | 非空 | 逗号隔开 |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
/space/geo/object/listByDins?
dins=144115192394050040,144115192394173152&
token=****************************
2
3
返回参数
名称 类型 说明 示范值 code number 返回码 返回码;0表示成功,非0表示出错 success Boolean 错误信息 返回信息;true 表示成功,false 表示出错 data array 对象数组 wId string 对象的唯一标识 "0007e43d-45d7-44c0-acfc-fc5539b6516a", poiId string POI编号 "4403002230221018_9", name string 设备名称 "蓝牙ibeacon", level number 对象所属层级 9, longitude number 经度 113.935327719, latitude number 纬度 22.522594372, height number 绝对高度 86.45, poiCode string 分类编码 "w0907015", positionText string 位置描述 "腾讯滨海大厦_滨海南塔_F18" 返回示例
{
"code": 0,
"data": [
{
"wId": "56b0a141-82c6-4c4d-9cd5-a90fa0b2d5cf",
"poiId": "44030022302210190200295_9",
"name": "优图盒子",
"boothId": "南门_1903",
"level": 9,
"longitude": 65.77724999189377,
"latitude": 81.76209999900311,
"height": 87.8,
"poiCode": "w0713002",
"sn": "035BCC78358C4a7a",
"din": "144115192394173152",
"subId": "",
"cadFloor": "F19",
"positionText": "腾讯滨海大厦_滨海北塔_19F_西梯-南门_1903",
"innerHeight": 0
},
{
"wId": "765b56cf-284a-4c47-9f6b-d0705dd2b38e",
"poiId": "44030022302210360200096_9",
"name": "优图盒子",
"boothId": "北门_3601",
"level": 9,
"longitude": 72.47675005160272,
"latitude": 43.75605000089854,
"height": 165.5,
"poiCode": "w0713002",
"sn": "02FE1C4A6E1C4436",
"din": "144115192394050040",
"subId": "",
"cadFloor": "F36",
"positionText": "腾讯滨海大厦_滨海南塔_36F_西梯-北门_3601",
"innerHeight": 0
}
],
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# 16. 列出建筑列表
- 功能描述
列出当前所在项目所有建筑 不含geojson地理信息
- 请求URL:
/space/geo/object/listBuildings
- 请求方式:
GET
- 请求参数
名称 | 类型 | 是否必传 | 数据约束 | 描述 |
---|---|---|---|---|
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
/space/geo/object/listBuildings?
token=****************************
2
- 返回参数
名称 | 类型 | 说明 | ||
---|---|---|---|---|
address | String | 地址 | ||
level | Num | 所属层级,6(建筑)、7(楼层)、8(房间)、9(设备点) | ||
city | String | 城市 | ||
latitude | Num | 纬度 | ||
buildingExtension | Struct | 建筑拓展字段 | ||
hasDevice | Boolean | 是否有设备 | ||
buildingId | String | 建筑ID | ||
buildingSubtype | String | 建筑子类型 | ||
province | String | 建筑所在省 | ||
district | String | 建筑所在区 | ||
name | String | 建筑名称 | ||
occupiedArea | Num | 占用面积 | ||
poiId | String | POI编码 | ||
buildingType | String | 建筑类型 | ||
longitude | Num | 经度 | ||
height | Num | 高度 |
- 返回示例
{
"code": 0,
"data": [
{
"address": "上海市上海市黄浦区淮海中路2-8号(淮海中路西藏南路)",
"level": 6,
"city": "",
"latitude": 31.225639999999995,
"buildingExtension": {},
"hasDevice": true,
"buildingId": "203d7d71-f339-4b4d-8842-29c16c0a3011",
"buildingSubtype": "279",
"province": "上海市",
"district": "",
"name": "兰生大厦",
"occupiedArea": 59273.23,
"poiId": "310000000000",
"buildingType": "272",
"longitude": 121.48038,
"height": 0
}
],
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# 17. 获取建筑详情
- 功能描述
获取建筑楼层、分塔楼层、位置等具体信息
- 请求URL:
/space/geo/object/getBuildingInfo
- 请求方式:
GET
- 请求参数
名称 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
buildingId | String | 是 | 非空 | 建筑wid |
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
/space/geo/object/getBuildingInfo?
buildingId=203d7d71-f339-4b4d-8842-29c16c0a3011&
token=****************************
2
3
- 返回参数
名称 | 类型 | 说明 | |
---|---|---|---|
floorList | Array | 分塔栋建筑楼层列表 | |
floorList.wId | String | 分塔栋楼层 wId | |
floorList.buildingFloorWid | String | 所属整体楼层的wId(请注意仔细区分塔栋的楼层wId,二者不是同一概念) | |
floorList.floorHeight | Num | 楼层高度 | |
floorList.name | String | 楼层名称 | |
floorList.alias | String | 空间别名 | |
floorList.poiId | String | Poi编码 | |
floorList.floorIndex | Num | 楼层编号 | |
floorlist.poiCode | String | 分类编码 | |
floorList.baseRegion | String | 标准塔栋描述(如果无塔栋,则名称默认为建筑名称) | |
floorList.linkRegionNames | Array | 连接层名称 | |
floorList.extension | Struct | 拓展描述 | |
address | String | 地址 | |
level | Num | 所属层级,7(楼层)、8(房间)、9(设备点) | |
latitude | Num | 纬度 | |
buildingFloorList | Array | 独栋建筑楼层列表 | |
buildingId | String | 建筑ID | |
buildingSubtype | String | 建筑子类型 | |
name | String | 建筑名称 | |
occupiedArea | Num | 建筑面积(由用户据实填写) | |
poiId | String | Poi编码 | |
buildingType | String | 建筑类型 | |
height | Num | 高度 | |
longitude | Num | 经度 |
- 返回示例
{
"code": 0,
"data": {
"floorList": [
{
"wId": "d52a295f-75eb-4215-830b-d6eb063a2ef3",
"buildingFloorWid": "415eb1b7-78fd-4e33-8560-4470442b51a8",
"floorHeight": 8.55,
"name": "F40",
"alias": "",
"poiId": "31000000000010401100001",
"floorIndex": 40,
"poiCode": "c0201001",
"baseRegion": "兰生大厦",
"linkRegionNames": [],
"extension": {}
},
{
"wId": "6dcbb10c-b0cd-48b9-bad2-a00f3dcd4acc",
"buildingFloorWid": "f5b5c541-fced-4803-8943-fc555ab08a9f",
"floorHeight": 3.47,
"name": "F39",
"alias": "",
"poiId": "31000000000010391100001",
"floorIndex": 39,
"poiCode": "c0201001",
"baseRegion": "兰生大厦",
"linkRegionNames": [],
"extension": {}
}
],
"address": "上海市上海市上海市黄浦区淮海中路2-8号(淮海中路西藏南路)",
"level": 6,
"latitude": 31.225639999999995,
"buildingFloorList": [
{
"wId": "415eb1b7-78fd-4e33-8560-4470442b51a8",
"floorHeight": 8.55,
"name": "F40",
"alias": "",
"poiId": "3100000000001040",
"floorIndex": 40,
"poiCode": "m99999000",
"linkRegionNames": [],
"extension": {}
},
{
"wId": "f5b5c541-fced-4803-8943-fc555ab08a9f",
"floorHeight": 3.47,
"name": "F39",
"alias": "",
"poiId": "3100000000001039",
"floorIndex": 39,
"poiCode": "m99999000",
"linkRegionNames": [],
"extension": {}
}
],
"buildingId": "203d7d71-f339-4b4d-8842-29c16c0a3011",
"buildingSubtype": "279",
"name": "兰生大厦",
"occupiedArea": 59273.23,
"poiId": "310000000000",
"buildingType": "272",
"height": 0,
"longitude": 121.48038
},
"success": true
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
# 18. 获取建筑详情
- 功能描述
获取建筑楼层、分塔楼层、位置等具体信息
- 请求URL:
/space/geo/object/listRegions
- 请求方式:
GET
- 请求参数
名称 | 类型 | 是否必传 | 数据约束 | 描述 |
---|---|---|---|---|
poiCode | String | 是 | 非空 | 分类编码 |
buildingId | String | 是 | 非空 | 建筑wid |
token | String | 是 | 非空密钥,有效期20分钟,需重新登录 | 动态密钥,有效期20分钟,需重新登录 |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
/space/geo/object/listRegions?
poiCode=c0201001&
buildingId=203d7d71-f339-4b4d-8842-29c16c0a3011&
token=****************************
2
3
4
- 返回示例
{
"code": 0,
"data": {
"regions": [
{
"name": "兰生大厦"
}
]
},
"success": true
}
2
3
4
5
6
7
8
9
10
11
# 19.更新空间属性
- 功能描述
更新空间属性
- 请求URL:
/space/geo/object/updateAttributeInfo
- 请求方式:
POST
- 请求参数
名称 | 类型 | 必填 | 数据约束 | 描述 |
---|---|---|---|---|
wId | String | 是 | 非空 | 空间建筑、楼层、点位、设备的wId |
token | String | 是 | 非空且长度固定128个字符 | 动态密钥,有效期20分钟,需重新登录 |
project_id | String | 否 | 非空 | 项目编号 |
- 请求示例
/geo/object/updateAttributeInfo?
wId={wId}&
token={token}
2
3
- body
{
"alias": "这是一个别名"
}
2
3
- 返回示例
{
"code":0,
"data":{
"affectedRows":1
},
"success":true
}
2
3
4
5
6
7