OneNET Studio 简介 产品介绍 快速入门 设备接入与管理 应用开发
应用开发流程 新建项目 添加设备 设备分组 场景联动 应用数据流转 应用API 应用长连接 规则引擎(新)
运维监控 数据可视化 边缘计算 人工智能AI 位置定位 语音通话 工业互联网标识 权限管理 服务协议 更新日志

基站定位开发指南

本页目录


本部分内容将以MQTT协议接入的设备为例,介绍设备通过定义物模型“基站定位”系统功能点实现设备定位和经纬度数据推送的操作过程。

1.开通基站定位服务

用户首次使用基站定位服务时,需要登录开发者中心,选择增值服务 > 基站定位,开通基站定位服务。

若您直接在产品开发阶段添加了系统功能点“基站定位”,但没有开通基站定位服务,将无法正常调用位置定位提供的开放API或者进行经纬度数据推送。


图 1 开通基站定位服务

图 2 基站定位控制台

2.添加基站定位系统功能点

选择设备接入 > 产品管理 > 产品详情,为产品添加系统功能点“基站定位”。

该功能点为数组类型,最大支持基于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

图 3 添加系统功能点“基站定位”入口

图 4 选择系统功能点“基站定位”

图 5 功能点列表

3. 数据上报(MQTT设备模拟器)

此处采用MQTT.fx模拟设备接入物联网平台。请前往mqtt.fx官网进行下载,本文档使用的是MQTT.fx Version 1.7.1客户端软件。

您也可以使用平台提供的设备调试进行上下行数据调试。

优化提示:采用多基站定位并上报数据时,基站的排列顺序不同,会产生不同精度的定位结果,建议按照设备从每个基站接收到的信号强弱(ss)排序后再上报,可提高设备定位精准度。

1)操作前提

您已经通过设备接入服务在产品下添加了相应的MQTT设备。

2)设备激活(MQTT.fx配置)

打开MQTT.fx客户端,进入客户端配置页面。


图 6 打开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,导入证书

  • Client ID: 设备名称(本例为:device1)
  • User Name:产品id (本例为:0miYdTzp2i)
  • Password:token(本例为:version=2018-10-31&res=products%2F0miYdTzp2i%2Fdevices%2Fdevice1&et=1598229625&method=md5&sign=mS2KenTgQwo%2BlOD6a3whFA%3D%3D)
  • 前往token算法

图 7 MQTT.fx客户端配置

配置完成后,在配置文件下拉列表中选择配置MQTT相应项目,点击conncent,切换到开发者中心,设备在页面处于在线状态。


图 8 选择配置MQTT相应项目


图 9 设备已接入平台


图 10 设备在线

3)数据上报(MQTT.fx模拟)

订阅属性上报结果通知消息

为了确保设备上传消息确实被平台所接受处理,设备可以订阅系统topic获取属性上报结果消息,属性上报回复topic为:

$sys/{pid}/{device-name}/thing/property/post/reply

本例中topic为:$sys/0miYdTzp2i/device1/thing/property/post/reply


图 11 订阅属性上报结果通知消息

基站信息数据上报

“基站定位”系统功能点为“属性”类型,属性上报的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
            }
        ]
    }
  }
}

图 12 多基站信息上报


图 13 MQTT.FX订阅数据发送成功

4)上报记录

设备上报数据后,可在设备接入 > 设备管理 > 设备详情中查看该功能点数据上报记录。


图 14 设备上报基站信息记录

4. 经纬度数据推送

平台支持通过HTTP推送、消息队列MQ推送服务向企业服务器推送设备经纬度数据。

您需要在HTTP数据推送和消息队列MQ中创建相应的实例才可以添加推送规则。

查看HTTP数据推送详情

查看消息队列MQ详情

此处以HTTP数据推送为例。

1)创建项目

使用规则引擎对数据定义推送规则时,需要先创建项目,并将设备添加到项目中。(设备已绑定到项目可跳过此步骤)


图 15 添加项目

2)添加推送规则


图 16 添加推送规则入口


图 17 选中设备位置数据消息源


图 18 选择消息目的地

3)接收推送消息

配置推送规则后,当设备上报基站信息时,平台将会向企业服务器根据自定义规则推送消息源数据。


图 19 接收推送数据

5. 位置信息查询

1)设备上报基站信息后,您可以在开发者中心基站定位控制台页面查询设备的位置。


图 20 查询设备位置

2)或者通过平台提供的开放API进行位置查询。

查看API详情

个搜索结果,搜索内容 “

    0 个搜索结果,搜索内容 “