根据围栏 ID 查询围栏

更新时间:2023-06-15 04:57:42

本文介绍根据围栏 ID 查询围栏的 API。

接口描述

根据围栏 ID 查询对应的围栏数据。

接口地址

GET: /v2.0/iot-01/fences/batch

请求参数

参数名 类型 参数位置 是否必填 说明
fence_ids String query true 围栏 ID,多个 ID 以逗号分隔,fence_id 上限为 50 个
coord_type_output String query false 经纬度定位坐标系类型:
  • WGS84:谷歌坐标系
  • GCJ02:高德
  • BD09LL:百度
  • 不传:国内默认高德,国外默认谷歌

返回参数

参数名 类型 说明
result List

result 说明

参数名 类型 说明
fence_id Long 围栏 ID
fence_name String 围栏名称
bind_type Integer 围栏绑定类型:
  • 1:私有围栏
  • 2:公共围栏
entity_id String 监控对象 ID
shape String 围栏形状:
  • circle:圆形
  • polygon:多边形
fence_data FenceShapeDataRes 围栏数据点数据
warn_rule Integer 告警规则:
  • 1:进围栏
  • 2:出围栏
  • 3:进出围栏
enable Integer 开关状态:
  • 0:关闭
  • 1:开启

fence_data 说明

参数名 类型 说明
circle CircleDataRes 圆形围栏数据
polygon List 多边形围栏数据

polygon 说明

参数名 类型 说明
lon Double 多边形点经度
lat Double 多边形点纬度

circle 说明

参数名 类型 说明
radius Integer 围栏半径,单位米
lon Double 围栏中心点经度
lat Double 围栏中心点纬度

请求示例

GET: /v2.0/iot-01/fences/batch?fence_ids=44009,44010

返回示例

{ "result": [ { "shape": "circle", "fence_data": { "circle": { "lon": 31.218, "radius": 300, "lat": 121.3604 } }, "entity_id": "vdevo16245017293****", "bind_type": 1, "fence_id": 44009, "fence_name": "第一个围栏", "enable": 0, "warn_rule": 1 }, { "shape": "circle", "fence_data": { "circle": { "lon": 31.218093093844796, "radius": 200, "lat": 121.36040929664462 } }, "entity_id": "", "bind_type": 2, "fence_id": 44010, "fence_name": "第一个围栏", "enable": 1, "warn_rule": 1 } ], "t": 1625222073106, "success": true }

错误码

参考 错误码