快速接入设备位置到地图

步骤一、创建产品

1. 登录物联网平台控制台。
2. 参考创建产品，创建带有位置属性的产品。
   
   
3. 参考单个创建设备，添加设备。
   
   

   保存设备的设备证书（ProductKey、DeviceName、DeviceSecret），以备后续使用。

4. 参考二维数据可视化设备定位中的设备上报经纬度内容，为设备所属产品添加地理位置功能，并上报设备位置到云端。
   
   

步骤二、模拟设备

使用Link Kit SDK提供的Java SDK Demo模拟设备的GPS模块。

1. 下载Java SDK Demo并在本地解压。
2. 在device_id.json文件中，填写已保存的设备证书（ProductKey、DeviceName、DeviceSecret）信息。
   
   
3. 在test_case.json文件中，设置设备要上报的位置属性。
   由于在物联网平台控制台，位置属性产品的 产品详情 > 功能定义页面中设置的GeoLocation属性定义是struct结构体，因此 test_case.json文件中的 value参数需要填结构体子属性的json串。可单击子属性名字后的 编辑查看其标识符。
   
   
   test_case.json文件中，填好结构体子属性的json串后，文件内容如下所示：
   
   

   说明 可使用高德开放平台经纬度拾取工具，设置设备经纬度（Longitude、Latitude）。
4. Demo程序的入口在HelloWorld.java文件中，本Demo中我们只需要设备上报位置的属性，因此需简化HelloWorld.java代码。简化后的代码如下所示：

   public class HelloWorld {
       private static final String TAG = "HelloWorld";
   
       private String pk, dn;
       private ThingSample thingTestManager = null;
   
   
       public static void main(String[] args) {
           ALog.d(TAG, "Hello world!");
           ALog.setLevel(ALog.LEVEL_DEBUG);
           HelloWorld manager = new HelloWorld();
           ALog.d(TAG, "args=" + Arrays.toString(args));
           System.out.println(System.getProperty("user.dir"));
           String diPath = System.getProperty("user.dir") + "/device_id.json";
           String deviceInfo = FileUtils.readFile(diPath);
           if (deviceInfo == null) {
               ALog.e(TAG, "main - need device info path.");
               return;
           }
           Gson mGson = new Gson();
           DeviceInfoData deviceInfoData = mGson.fromJson(deviceInfo, DeviceInfoData.class);
           if (deviceInfoData == null) {
               ALog.e(TAG, "main - deviceInfo format error.");
               return;
           }
           ALog.d(TAG, "测试一机一密和物模型");
           manager.init(deviceInfoData);
       }
   
   
       public void init(final DeviceInfoData deviceInfoData) {
           this.pk = deviceInfoData.productKey;
           this.dn = deviceInfoData.deviceName;
           LinkKitInitParams params = new LinkKitInitParams();
           /**
            * 设置 Mqtt 初始化参数
            */
           IoTMqttClientConfig config = new IoTMqttClientConfig();
           config.productKey = deviceInfoData.productKey;
           config.deviceName = deviceInfoData.deviceName;
           config.deviceSecret = deviceInfoData.deviceSecret;
           config.channelHost = pk + ".iot-as-mqtt." + deviceInfoData.region + ".aliyuncs.com:1883";
           /**
            * 是否接受离线消息
            * 对应 mqtt 的 cleanSession 字段
            */
           config.receiveOfflineMsg = false;
           params.mqttClientConfig = config;
   
           /**
            * 设置初始化三元组信息，用户传入
            */
           DeviceInfo deviceInfo = new DeviceInfo();
           deviceInfo.productKey = pk;
           deviceInfo.deviceName = dn;
           deviceInfo.deviceSecret = deviceInfoData.deviceSecret;
   
           params.deviceInfo = deviceInfo;
   
           /**
            * 设置设备当前的初始状态值，属性需要和云端创建的物模型属性一致
            * 如果这里什么属性都不填，物模型就没有当前设备相关属性的初始值。
            * 用户调用物模型上报接口之后，物模型会有相关数据缓存。
            */
           Map<String, ValueWrapper> propertyValues = new HashMap<String, ValueWrapper>();
           // 示例
           // propertyValues.put("LightSwitch", new ValueWrapper.BooleanValueWrapper(0));
           params.propertyValues = propertyValues;
   
           thingTestManager = new ThingSample(pk, dn);
           LinkKit.getInstance().init(params, new ILinkKitConnectListener() {
               public void onError(AError aError) {
                   ALog.e(TAG, "Init Error error=" + aError);
               }
   
               public void onInitDone(InitResult initResult) {
                   ALog.i(TAG, "onInitDone result=" + initResult);
                   thingTestManager.readData(System.getProperty("user.dir") + "/test_case.json");
                   thingTestManager.report();
               }
           });
       }
   }

5. 执行HelloWorld.java文件，使设备的位置生效。

步骤三、创建二维数据可视化场景

1. 参考二维数据可视化，创建一个场景。
   
   

   其中，目标产品或设备组选择产品，并从下拉框中选择已创建的位置属性产品。

2. 进入二维可视化场景页面查看设备实时位置。
   
   

至此，您已经将您的物联网设备快速的接入到地图中了。

下一步

可参考分享场景，将已创建二维数据可视化场景分享给其他人。