不写一行代码，为 App 添加设备地图组件

ThingsCloud 支持完善的设备位置管理和设备地图，在各个领域的客户中得到了广泛的应用。

这些客户通过使用设备地图来实时监控和管理他们的设备，提高运营效率和生产力。无论是物流行业、制造业还是能源领域，设备地图都为客户提供了实时的设备状态和位置信息，帮助他们更好地进行决策和优化运营。

借助 ThingsCloud 设备地图，客户还可以轻松追踪设备的运动轨迹、检查设备的健康状况，并及时采取措施以降低风险和提升效率。无论您是初创企业还是大型集团，设备地图都能满足您的需求，助力业务取得更大的成功。

设备位置在各领域广泛应用

在我们的支持工作和客户实践中，物联网设备位置的常见应用场景包括：

• 冷链物流：通过设备地图组件，物流公司可以实时追踪运输车辆的位置，确保货物安全，提高运输效率和准确性。
• 汽车租赁：方便客户在手机上查询并定位租赁车辆的位置。在行驶中，利用 ThingsCloud 开箱即用的告警通知，实现超速报警，当行驶速度超过最大限速值，并持续一定次数，自动发送短信给驾驶者。
• 安防：通过设备地图，监控摄像头的位置一目了然，通过视觉识别上报和设备位置的结合，提高安防系统的响应速度和精确性。
• 资产追踪：通过设备地图和电子围栏规则，园区管理方可以追踪和管理移动设备、货物或其它资产的位置，提高资产管理的效率和可靠性。
• 农业畜牧：通过支持位置采集的设备对牛羊牲畜进行定位和监测，帮助牧民实时追踪动物的位置和健康状况，提高养殖管理的效率和减少损失。

在这些应用场景中，设备地图为客户提供了实时位置信息，帮助他们更好地管理和控制相关操作，提高工作效率和客户满意度。

添加 App 地图组件

现在，设备地图不仅可以在控制台和可视化看板中使用，您还可以在用户应用 ThingsX 中添加设备地图组件，用来显示设备扩展信息中的位置信息，可以是设备上报的实时位置，也可以是在您在控制台编辑的设备位置。

在 App 设备面板编辑器中，可以设置地图模式，支持普通模式和卫星模式。此外，您还可以设置地图组件的高度，以及选择图标，并设置缩放比例、俯仰角度、旋转角度等。如下图：

支持全平台移动端

地图组件支持 ThingsX 全平台，包括 iOS、Android、微信小程序、移动 Web 版。

集成地图 Key

在 App 中添加设备地图组件之前，您需要在项目的第三方集成设置中，配置自己的地图 Key，如下图：

详细介绍请浏览：

• 如何集成第三方地图服务？
• 助力设备出海，ThingsX 全面支持 Google Map 地图组件

如何关联设备的位置信息？

ThingsX 的地图组件直接关联设备扩展信息中的位置信息，请在 设备类型 > 扩展信息 中开启 设备位置，如下图：

开启后，便可以在设备详情页的信息中，手动编辑位置，如下图：

可以通过地址搜索联想，也可以直接在下边输入经纬度。

如何使用设备上报的位置数据？

如果硬件设备通过 GNSS 模块直接上报经纬度数据，我们可以使用设备上报的位置信息。首先需要在设备类型的功能定义中，添加相应的位置属性，如下图：

然后，在扩展信息的编辑选项中，勾选使用设备上报位置，并选择对应的位置属性。如下图：

如何在控制台和可视化看板中使用设备地图？

如果您还不了解设备地图的基础用法，请回顾阅读以下内容：

• ThingsCloud 全新设备地图上线，助力物联网位置服务
• 如何在设备地图上显示设备位置？
• 物联网可视化看板基础教程 | 设备位置地图
• 物联网可视化看板基础教程 | 设备地图跟随模式

题外篇：设备如何上报位置数据？

ThingsCloud 对任何支持定位的设备开放接入。

如果您是硬件端开发工程师，使用通信模组 MQTT 或 TCP 直接连接 ThingsCloud，上报位置信息非常简单，可直接上报设备属性，发送如下 JSON 数据格式，这是 ThingsCloud 支持的地理位置数据类型。

{
    "location": {
        "lat": 41.0203,
        "lng": 38.3183
    }
}

对于采用其它二进制或文本格式协议的 GPS 设备，例如：JT808 或自定义协议，您可以和设备厂家沟通，使用 ThingsCloud 消息规则来自定义解析。例如：

• 银尔达 Air780EG 模块上报 GPS/LBS 位置数据解析

支持地理坐标系转换规则

对于 GPS 原始位置坐标，需要进行一定的坐标系转换，否则在国内地图服务中显示的位置会和实际位置有偏差。

ThingsCloud 消息规则内置 GPS 坐标系到 GCJ-02 坐标系（俗称火星坐标系）和 BD-08（百度坐标系）的转换，如下图：

自动转换后会生成新的设备位置属性，可在展示时优先使用。

关于设备位置和设备地图的用法，您学会了吗？快来试试吧！

物联网设备接入 ThingsCloud ，请参考 设备接入指南 和 教程。