为云手机 GPS 定位插件,一键搞定坐标!

本项目用于将华为云”查找设备”的定位能力接入 Home Assistant / Node-RED，实现围栏、回家自动化、电量提醒等场景。

很多手机定位方案死在”电源管理(省电杀后台)”，本项目通过华为云空间「查找设备」从云端获取位置，绕开本地后台限制，让回家/离家围栏自动化更稳定。

• 在 HA 地图上实时查看你的华为设备位置

• 监控设备电量，低电量时自动加速更新

• 显示设备所在的中文地址（需配置高德 API）

• 支持多设备同时追踪

• 在设备详情页显示高德地图（需安装 gaode_maps）

结合 HA 自动化或 Node-RED，可实现：

• 回家 / 离家围栏：进入或离开指定区域时，自动开关灯、空调、安防

• 进入小区触发：设备进入小区范围后自动执行回家准备流程

• 电量通知：设备电量低于阈值时推送提醒（通知、TTS、微信等）

• 长时间未移动提醒：设备位置长期不变时触发关怀通知，适用于老人监护场景

设备追踪器实体的经纬度、电量、地址等属性可直接在 Node-RED 中使用：

• 基于 latitude / longitude 计算距离、判断围栏

• 监听 state_changed 事件，按设备 ID 分流处理

• 与其他 HA 实体（门锁、灯光、传感器）组合编排复杂逻辑

1. 后端服务：Docker 容器，用 Playwright 模拟浏览器登录华为云空间

2. HA 插件：本自定义组件，从后端获取数据并创建 HA 实体

部署建议

本项目涉及华为账号登录凭据，强烈建议部署在内网环境，不要将后端服务暴露到公网。典型的安全部署方式：

• 后端服务运行在家庭局域网内的 NAS、软路由或 Home Assistant 同一主机上

• HA 通过内网 IP（如 http://192.168.1.100:8000）访问后端，无需端口映射到公网

• 如确需远程访问，请通过 VPN 或 Tailscale/ZeroTier 等内网穿透方案，避免直接暴露端口

• 不要在VPN(科学上网)环境部署

验证后端是否正常运行：

方式 A：HACS 安装（推荐）

1. 确保已安装 HACS

2. HACS → 集成 → 右上角三个点 → 自定义仓库

3. 添加https://github.com/MagicStarTrace/huawei_cloud，类别选择 “Integration“

4. 搜索”华为云服务”并安装

5. 重启 Home Assistant

方式 B：手动安装

1. 下载最新 Release

2. 将 custom_components/huawei_cloud 复制到 HA 的 custom_components 目录

3. 重启 Home Assistan

1. 设置 → 设备与服务 → 添加集成

2. 搜索 “华为云服务”

3. 填写：

• 后端服务地址：如 http://192.168.1.100:8000

• 华为账号 / 密码

• 高德 API 密钥（可选，申请方式见下方）

添加后你会看到：

1. 集成卡片立即出现，显示”华为云服务”设备和”服务状态”传感器

2. 服务状态传感器会实时显示当前进度：

• 初始化中 → 正在连接后端

• 等待登录 / 登录中 → 后端正在登录华为账号（约 30-60 秒）

• 正常（2台设备） → 一切就绪

3.通知栏会显示带进度条的初始化通知

4.登录成功后，设备追踪器和传感器实体自动出现

每台华为设备会创建 1 个追踪器 + 2 个传感器（地址、电量）。

添加后可在 设置 → 设备与服务 → 华为云服务 → 配置 中调整：

• 检查后端服务是否运行：curl http://你的服务器:8000/health

• 确认 HA 能访问后端地址（同一网络？防火墙？）

• 查看 HA 日志中的 huawei_cloud 相关信息

华为账号触发了验证码[多数情况下不会]，后端无法自动处理。解决方法：

1. 在浏览器中手动登录 华为云空间

2. 完成验证码验证

3. 在 HA 中重新加载集成

• 首次启动需 30-60 秒完成登录，请等待

• 设备关机或离线时位置不可用

• 设备离线超过 1 小时后缓存过期

需要配置高德地图 API 密钥（免费额度足够个人使用），申请步骤：

1. 注册/登录 高德开放平台

2. 进入 应用管理 → 我的应用 → 创建新应用

3.应用类型选择 出行

4.点击 添加 Key，服务平台选择 Web服务

5.将获取到的 Key 填入集成配置的「高德 API 密钥」字段

• 室内 GPS 信号弱，精度较低属于正常

• 设备追踪器的 location_accuracy 属性显示精度（单位：米）

• 开启”主动定位”可以获得更精确的位置

• Home Assistant 使用 WGS-84 坐标系（全球 GPS 标准）

• 设备追踪器的位置已自动转换为 WGS-84

• 如需国内地图坐标（高德/百度），可在实体属性中找到 gcj02_latitude / gcj02_longitude

如果本项目对你有帮助，欢迎在 GitHub 上点个 Star 支持一下。

• GitHub 仓库：https://github.com/MagicStarTrace/huawei_cloud

• GitHub Issues：适合 Bug 反馈、功能建议、适配问题（请附日志与截图）

本项目仅供个人学习和研究使用。使用者应遵守相关法律法规，不得用于非法用途。使用本项目产生的任何风险由使用者自行承担。

本项目通过华为云网页端接口进行数据获取。若官方对网页端接口进行调整、升级或策略变更，可能导致短期兼容性问题。本项目不隶属于华为官方。

▼▼▼

更多详情内容见原帖…