HomeAssistant集成之墨澜（高德）地图及设备追踪上篇（2025 年）

在本文正式开始前，如果小伙伴还没有看过本期内容提前预热帖，建议大家先快速看下，里面有福利哦《春节福利预热》！

什么是墨澜(高德)地图？

它是 Home Assistant 的定制化中国地图面板。Home Assistant 默认地图面板使用的服务是 OpenStreetMap，这是一款国外开源地图，由全球志愿者共同维护，本地化支持肯定没有国内高德、百度效果好，个人使用一段时间下来，墨澜（高德）地图是一款不错的替代品。

什么是 Device Tracker？

Device Tracker 可让被追踪设备将位置信息发送回 Home Assistant 中作为后续功能的输入。

Device Tracker 和 墨澜(高德)地图有什么关系？

其实没啥关系，Home Assistant 获取设备位置信息后，在墨澜(高德)地图中直观展示出来。

安装墨澜(高德)地图以及设备追踪有什么用？

主要用途包括：

1. 家庭成员以及宠物定位：

   • 设备追踪可以帮助确定家庭成员或者宠物项圈设备的位置，例如通过手机的 GPS 数据追踪家庭成员具体地理位置（如追踪年迈父母或孩子的行踪）。

2. 安全与防护：

   • 通过追踪移动设备（如智能门锁、智能摄像头等），可以在设备被搬动或非法移动时立即发出警报，提高家庭安全性。

3. 行程记录与分析：

   • 对于需要外出工作或移动的设备，追踪其行程记录可以帮助分析其使用频率、路线等数据，从而优化设备管理和使用。

4. 车辆或物品管理：

   • 在需要追踪车辆位置或高价值物品的场景中，设备追踪可以实时获取位置数据，确保物品或车辆的安全。

5. 基于位置的自动化：

   • 设备追踪能够与其他智能家居设备协同工作，基于位置变化触发自动化动作，例如当家庭成员靠近时自动开门、自动开启灯光或空调、启动车辆等。

综上所述，安装墨澜(高德)地图并启用设备追踪功能，能够带来许多实际且便捷的应用场景，尤其是用途一和五。

技术声明-关于设备追踪功能的使用

设备追踪功能是基于 Home Assistant 实现的技术方案，旨在为用户提供便捷的设备管理和智能家居体验。然而，技术本身是中立的，它的用途取决于使用者的行为。在此特别声明以下几点：

• 合法使用
  本功能仅限用于合法用途，例如保护家庭安全、优化设备管理等场景。严禁将设备追踪功能用于任何形式的非法活动，包括但不限于未经许可的个人监控、侵犯他人隐私或跟踪他人。

• 尊重隐私
  如果您计划在非个人设备上启用设备追踪功能，请事先获得设备所有者或使用者的明确同意。在启用此功能前，确保相关方了解其工作原理和目的，并对相关数据的使用达成共识。

• 责任归属
  使用此功能时，您有责任遵守当地的法律法规。因不当使用技术造成的任何后果，由使用者自行承担。

技术无罪，使用者需负责。

由于内容较多，我将分为上、中、下三篇文章教大家如何从零开始安装。

在 HA 中安装墨澜(高德)地图之前，你还需要通过高德开放平台获取如下几个信息要素：

• Web 端 Key

• 安全密钥（JS Code）

1.打开链接：https://lbs.amap.com，如果没有账户自己注册一个，登录后点击右上角的控制台

2.点击左侧 应用管理->我的应用

3.点击右上角 创建新应用

应用名称随便写一个，应用类型我这里选的导航，最后新建出来

4.此时对新建的应用 添加 Key

5.名称随便填一个，记住服务平台一定是 Web端（JS API）

最后，点击提交

6.此时我们就可以获取到 Web端Key 和 安全密钥

将二者信息复制下来备用，待会就会用到

接下来在 Home Assistant 中安装墨澜(高德)地图插件，当前我的 HA OS 信息如下：

7.HACS->右上角三个点->Custom repositories

输入插件地址：https://github.com/dscao/gaode_maps

添加后可以看到墨澜(高德)地图

8.此时回到 HACS 中搜索“高德”就可以看到墨澜(高德)地图

9.下载墨澜(高德)地图

10.安装后会提示重启 HA

11.重启系统后，设置->设备与服务->添加集成，搜索地图

点击墨澜地图

12.输入对应信息

从上到下依次：

• Web 端 Key

• 安全密钥（JS Code）

• HA 长期访问令牌

注意：HA 长期令牌不知如何获取可以点击这篇文章《Home Assistant 集成之国家电网》

13.提交之后显示安装成功

14.此时系统左侧可以看到墨澜地图的标签

点击墨澜地图后，我们能看到我的家(家地理位置如果不正确不慌，下一篇带你修正)，下面导航栏从左到右依次：

放大，缩小，实时交通，Home显示开关，家范围开关，追踪设备列表（下两期文章就是围绕设备追踪展开）

右上角切换卫星地图显示如下

至此，墨澜(高德)地图以及设备追踪(Device Tracker)上篇到此结束，后两篇将带大家如何实现设备追踪并显示在墨澜地图上。

后记：

1. 本篇文章是接下来两天内容的基础，因此务必确保安装成功。

2. 如果你无法通过公网访问你的 Home Assistant，那么后续两天的内容无法往下进行。