Appearance
创建平台围栏
接口说明
为设备imei创建一个平台围栏信息(一个imei最多创建20个平台围栏;围栏名称不可包含特俗字符;围栏名称不可重复)
请求URL
本接口通用参数里面method的值为jimi.open.plat.fence.create
HTTP请求方式
POST
请求参数
(1)通用参数
参见: 通用参数
(2)私有参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 描述 |
|---|---|---|---|---|
| access_token | String | 是 | 访问令牌,表明其是一个合法第三方 | |
| imei | String | 是 | 无 | 设备imei号 |
| fence_name | String | 是 | 无 | 围栏名称 |
| fence_shape | String | 是 | circle | 围栏形状(只能为circle——圆) |
| status | String | 否 | 无 | in-进围栏,out-出围栏,all-进出都有 |
| lng | double | 是 | 无 | 经度 |
| lat | double | 是 | 无 | 纬度 |
| radius | double | 是 | 无 | 围栏半径(200~999900;单位:米) |
| map_type | String | 是 | 无 | 地图类型(baidu/google) |
| scale | int | 是 | 无 | 缩放级别(3~19) |
返回值
| 参数 | 类型 | 描述 |
|---|---|---|
| code | Int | 返回码: 0: 正确返回 其它: 失败。参考错误码说明 |
| message | String | 如果code不为0,会有相应的错误信息提示 |
| result | String | 返回的数据,成功后返回围栏序号 |
result参数列表:
| 参数 | 类型 | 描述 |
|---|---|---|
| imeis | String | 设备IMEI集合 |
| fenceName | String | 电子围栏名称 |
| fenceId | String | 平台围栏ID |
正确返回示例:
js
{
"code": 0,
"message": "成功",
"result": {
"imeis": "456789123456801",
"fenceName": "11111111111",
"fenceId": "0f566e9d9e0b4a2499832cd158b0c63b",
}
}错误返回示例:
js
{
"code": 12008,
"message": "围栏超过创建个数",
"result": null
}