本章主要描述二维数据可视化设备定位方法中的云端推理经纬度方法。

云端推理经纬度是根据设备网络信息、IP地址等数据进行智能推理出经纬度,分为基站定位信息和WiFi信息定位,两种方式的设备上报信息不同。

WiFi定位

需要设备将WiFi定位信息主动上传到云端。

  1. 物联网平台控制台左侧导航栏选择设备管理 > 产品,在设备所属产品的右侧操作栏中单击查看
  2. 产品详情页面,选择功能定义,单击自定义功能后的添加功能
  3. 添加自定义功能弹窗中,选择事件功能类型。
    自定义功能
  4. 配置事件参数,然后单击确定

    参数设置
    表 1. WiFi定位事件参数
    参数 取值
    功能类型 事件
    功能名称 LocationInfo
    标识符 LocationInfo
    事件类型 信息
    输出参数 添加本文下方表格表 2中的参数。
    表 2. WiFi定位事件输出参数
    标识符 含义 数据类型 规则说明 是否必填 描述
    imei 手机 imei 号 text(字符串) 提高定位精度和排查问题。 若没有可换的设备唯一识别码,可不填写也能获取到结果。高德地图要求必填。
    idfa ios 手机的 idfa text(字符串) 提高定位精度和排查问题。
    smac 手机 mac 码 text(字符串) 提高定位精度和排查问题。
    imsi 移动用户识别码 text(字符串) 提高定位精度和排查问题。
    tel 手机号码 text(字符串)
    mmac 已连热点mac信息 text(字符串) 格式为mac,signal,ssid,如:f0:7d:68:9e:7d:18,-41,TPLink 建议传入该参数,否则影响定位精度。
    macs WiFi列表中mac 信息 text(字符串) 单mac信息同mmac,mac之间使用“|”符号分隔。必须填写2(含)~30 个以内的字符方可正常定位。请不要包含移动WiFi信息。
  5. 设备会通过标准的设备协议上报位置到云端。
    设备上报协议:
    • TOPIC:/sys/{productKey}/{deviceName}/thing/event/property/post
    • REPLY TOPIC:/sys/{productKey}/{deviceName}/thing/event/property/post_reply

    请求示例如下所示。

    {
        "id" : "123",
        "version":"1.0",
        "params" : {
               "mmac":"4c:48:da:26:ea:d9,-56,alibaba-inc",
               "macs":"4c:48:da:26:ea:d8,-56,alibaba-guest|e6:a4:71:6e:45:83,-58,DIRECT-RIDESKTOP-P0FPLV4mshO"
             },
        "method":"thing.event.LocationInfo.post"  
    }

    关于上报设备信息的详细说明请参见设备属性、事件、服务

基站定位

基站定位的上报字段和WiFi定位有所不同。

使用基站定位时,为设备所属产品设置如下事件参数。


参数设置
表 3. 基站定位事件参数
参数 取值
功能类型 事件
功能名称 LocationInfo
标识符 LocationInfo
事件类型 信息
输出参数 添加本文下方表格表 4中的参数。
表 4. 基站定位事件输出参数
标识符 含义 数据类型 规则说明 描述
imei 手机imei号 text(字符串) 提高定位精度和排查问题。 如没有可换成设备唯一识别码。高德要求必填,但是不填写也能获取到结果
smac 手机mac码 text(字符串) 提高定位精度和排查问题。
imsi 移动用户识别码 text(字符串) 提高定位精度和排查问题。
nearbts 周边基站信息(不含接入基站信息) text(字符串) 格式如下:

基站信息 1|基站信息 2|基站信息 3.....

cdma 是否为cdma text(字符串) 是否为cdma。
  • 非cdma:0
  • cdma:1
bts 接入基站信息 text(字符串) 接入基站信息, 内部参数说明如下:
  • 非cdma:格式为mcc,mnc,lac,cellid,signal
  • cdma:格式为sid,nid,bid,lon,lat,signal

    其中 lon和lat可为空,则格式为sid,nid,bid,,,signal

设备上报协议:

  • TOPIC:/sys/{productKey}/{deviceName}/thing/event/property/post
  • REPLY TOPIC:/sys/{productKey}/{deviceName}/thing/event/property/post_reply

请求格式如下所示。

  • 设备请求示例1(非cdma)
    {
        "id" : "123",
        "version":"1.0",
        "params" : {
                "imei":"352315052834187",
                "smac":"E0:DB:55:E4:C7:49",
                "cdma":"0",
                "bts":"460,01,40977,2205409,-65",
                "nearbts":"460,01,40977,2205409,-65|460,01,40 977,2205409,-65|460,01,40977,2205409,-65" 
            }
        },
        "method":"thing.event.LocationInfo.post"  
    }
  • 设备请求示例2(cdma)
    {
        "id" : "123",
        "version":"1.0",
        "params" : {
                "imei":"0000",
                "smac":"E0:DB:55:E4:C7:49",
                "cdma":"1",
                "bts":"13824,1,1838,1674723,575739,-52"    
            }
        },
        "method":"thing.event.LocationInfo.post"  
    }

关于上报设备信息的详细说明请参见设备属性、事件、服务