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

前提条件

已为设备定义物模型属性GeoLocation，操作方法请参见设备属性上报位置（Geolocation）。
说明 云端推理经纬度是将LocationInfo事件转化为GeoLocation属性进行存储的。配置GeoLocation属性参数时，高度、经度、纬度子参数的属性名a和l必须小写，坐标系统的C必须大写，即altitude、latitude、longitude、CoordinateSystem。

背景信息

云端推理经纬度是根据设备网络信息、IP地址等数据智能推理出经纬度，分为基站定位信息和WiFi定位信息。两种方式下设备上报信息不同，详情请参见本文下方的WiFi定位和基站定位中的参数设置。

WiFi定位

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

  1. 在物联网平台控制台对应实例下的左侧导航栏选择设备管理 > 产品，在设备所属产品的右侧操作栏中单击查看。
  2. 在产品详情页面，选择功能定义，单击编辑草稿 > 添加自定义功能。
  3. 在添加自定义功能对话框中，选择事件功能类型。
  4. 配置事件参数，单击确认，然后单击页面右下角的发布更新。
    表 1. WiFi定位事件参数
    参数取值
    功能类型事件。
    功能名称LocationInfo。
    标识符LocationInfo。
    事件类型信息。
    输出参数添加本文下方表格WiFi定位事件输出参数中的参数。
    表 2. WiFi定位事件输出参数
    标识符含义数据类型规则说明是否必填描述
    imei手机IMEI号text（字符串）提高定位精度和排查问题。否若没有可换的设备唯一识别码，可不填写。使用高德地图时要求必填。
    idfaiOS手机的IDFAtext（字符串）提高定位精度和排查问题。否无。
    smac手机MAC码text（字符串）提高定位精度和排查问题。否无。
    imsi移动用户识别码text（字符串）提高定位精度和排查问题。否无。
    tel手机号码text（字符串）无。否无。
    mmac已连热点MAC信息text（字符串）格式为mac,signal,ssid，如：f0:7d:68:9e:7d:18,-41,TPLink。是建议传入该参数，否则影响定位精度。
    macsWiFi列表中MAC信息text（字符串）单MAC信息同mmac，MAC之间使用竖线（|）进行分隔。必须填写2（含）~30 个以内的字符方可正常定位。请不要包含移动WiFi信息。是无。
  5. 设备会通过标准的设备协议上报位置到云端。
    设备上报协议：
    • 请求Topic：/sys/${productKey}/${deviceName}/thing/event/LocationInfo/post
    • 响应Topic：/sys/${productKey}/${deviceName}/thing/event/LocationInfo/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. 基站定位事件输出参数
标识符含义数据类型规则说明描述
imei手机IMEI号text（字符串）提高定位精度和排查问题。如没有可换成设备唯一识别码。高德显示为必填项，但是不填写也能获取到结果。
smac手机MAC码text（字符串）提高定位精度和排查问题。无。
imsi移动用户识别码text（字符串）提高定位精度和排查问题。无。
nearbts周边基站信息（不含接入基站信息）text（字符串）格式如下：

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

无。
cdma是否为CDMAtext（字符串）是否为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。

说明 signal使用指标RSSI（Received Signal Strength Indication）。
无。

设备上报协议：

  • 请求Topic：/sys/${productKey}/${deviceName}/thing/event/LocationInfo/post
  • 响应Topic：/sys/${productKey}/${deviceName}/thing/event/LocationInfo/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"  
}

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

相关文档

如何获取设备上报的物模型数据？