云服务 API 参考设备高级服务设备位置服务电子地理围栏根据围栏 ID 查询围栏

根据围栏 ID 查询围栏

更新时间：2023-06-20 14:52:24下载pdf

本文介绍根据围栏 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
}

错误码

参考错误码。

上一篇查询所有围栏

下一篇批量查询私有围栏