本部分内容将以MQTT协议接入的设备为例,介绍设备通过定义物模型“基站定位”系统功能点实现设备定位和经纬度数据推送的操作过程。
用户首次使用基站定位服务时,需要登录开发者中心,选择增值服务 > 基站定位,开通基站定位服务。
若您直接在产品开发阶段添加了系统功能点“基站定位”,但没有开通基站定位服务,将无法正常调用位置定位提供的开放API或者进行经纬度数据推送。
选择设备接入 > 产品管理 > 产品详情,为产品添加系统功能点“基站定位”。
该功能点为数组类型,最大支持基于3个基站的数据进行定位,每一个元素对应一个基站信息,元素结构如下:
| 字段 | 说明 |
|---|---|
| mnc | 移动网号 |
| mcc | 移动国家号码 |
| lac | 地区区域码 |
| cid | 基站码 |
| networkType | 网络制式 1 GSM 2 CDMA 3 WCDMA 4 TD_CDMA 5 LTE |
| ss | 信号强度 |
| signalLength | 当前基站广播信号强度 |
| ta | 移动台距以确定其发往基站的定时超前量 |
| flag | 基站信息数字进制 基站信息是10进制flag写10,不填则默认为10进制; 基站信息是16进制,flag必须写入16 |
此处采用MQTT.fx模拟设备接入物联网平台。请前往mqtt.fx官网进行下载,本文档使用的是MQTT.fx Version 1.7.1客户端软件。
您也可以使用平台提供的设备调试进行上下行数据调试。
优化提示:采用多基站定位并上报数据时,基站的排列顺序不同,会产生不同精度的定位结果,建议按照设备从每个基站接收到的信号强弱(ss)排序后再上报,可提高设备定位精准度。
您已经通过设备接入服务在产品下添加了相应的MQTT设备。
打开MQTT.fx客户端,进入客户端配置页面。
设置Profile Name、接入地址与端口、Client ID、User Name与Password,其中参数设置方式如下:
本例为测试环境ip端口,请修改为线上环境对应的ip端口
1、加密:183.230.102.116:8883
2、不加密:218.201.45.7:1883
如果采用加密方式,需要设置SSL/TLS,选择CA certificate file,导入证书
配置完成后,在配置文件下拉列表中选择配置MQTT相应项目,点击conncent,切换到开发者中心,设备在页面处于在线状态。
为了确保设备上传消息确实被平台所接受处理,设备可以订阅系统topic获取属性上报结果消息,属性上报回复topic为:
$sys/{pid}/{device-name}/thing/property/post/reply
本例中topic为:$sys/0miYdTzp2i/device1/thing/property/post/reply
“基站定位”系统功能点为“属性”类型,属性上报的topic为:
$sys/{pid}/{device-name}/thing/property/post
本例中topic为:$sys/0miYdTzp2i/device1/thing/property/post
上报数据成功后,订阅的属性上报会返回success。
OneJSON请求数据格式如下:
(1)单基站定位
{
"id": "1",
"version": "1.0",
"params": {
"$OneNET_LBS": {
"value":[{
"cid":21089,
"lac":6334,
"mcc":460,
"mnc":0,
"networkType":5,
"ss":-12,
"ta":1,
"flag":10
}
]
}
}
}
(2)多基站定位:
{
"id": "1",
"version": "1.0",
"params": {
"$OneNET_LBS": {
"value": [
{
"cid": 21089,
"lac": 6334,
"mcc": 460,
"mnc": 0,
"networkType": 5,
"ss": -12,
"ta": 1,
"flag": 10
},
{
"cid": 21089,
"lac": 6334,
"mcc": 460,
"mnc": 0,
"networkType": 5,
"ss": -12,
"ta": 1,
"flag": 10
}
]
}
}
}
设备上报数据后,可在设备接入 > 设备管理 > 设备详情中查看该功能点数据上报记录。
平台支持通过HTTP推送、消息队列MQ推送服务向企业服务器推送设备经纬度数据。
您需要在HTTP数据推送和消息队列MQ中创建相应的实例才可以添加推送规则。
此处以HTTP数据推送为例。
1)创建项目
使用规则引擎对数据定义推送规则时,需要先创建项目,并将设备添加到项目中。(设备已绑定到项目可跳过此步骤)
2)添加推送规则
3)接收推送消息
配置推送规则后,当设备上报基站信息时,平台将会向企业服务器根据自定义规则推送消息源数据。
1)设备上报基站信息后,您可以在开发者中心基站定位控制台页面查询设备的位置。
2)或者通过平台提供的开放API进行位置查询。