红米/小米手机坐标GPS集成插件

huyifanstar

# 小米云集成 (Xiaomi Cloud Integration) for Home Assistant

> Home Assistant自定义组件，用于小米云服务集成

该自定义组件通过连接小米云服务，将您的小米设备坐标地址集成到Home Assistant中。


## 前置

自己去申请高德API KEY https://lbs.amap.com/

应用类型选择出行，然后在添加key那里选择 Web服务


## 功能特点

- 连接小米云账户（小米/米家）
- 提供支持设备的位置追踪功能
- 从兼容的小米设备获取传感器数据

## GPS定位功能

### 位置追踪细节

本组件利用小米云服务的"查找设备"功能来获取设备的实时位置信息。工作原理如下：

1. **周期性定位更新**：组件每3分钟自动发送"查找设备"命令到小米云服务，触发设备进行定位
2. **坐标系转换**：支持多种坐标系格式，可在配置时选择
   - 原始坐标（original）：设备返回的原始坐标
   - 国测局坐标（GCJ02）：适用于大部分中国地图服务
   - WGS84坐标：全球GPS标准坐标系，适用于国际地图服务

### 位置数据属性

位置追踪实体提供以下属性：

- **经纬度**：设备的地理位置坐标
- **精度**：位置数据的精确度（以米为单位）
- **最后更新时间**：设备位置信息的最后更新时间
- **电量**：设备的电池电量百分比（如果设备支持）


### 坐标系选择

在集成配置过程中，您可以选择希望使用的坐标系类型：

- **original**：设备原始上报的坐标系
- **WGS84**：全球GPS标准坐标系，适用于国际地图服务
- **GCJ02**：国测局坐标系，适用于中国大陆地图服务

选择正确的坐标系对于准确显示设备在地图上的位置至关重要。

## 安装方法

### 使用HACS安装（推荐）

1. 确保您的Home Assistant已安装[HACS](https://hacs.xyz/)
2. 在HACS中添加此仓库作为自定义仓库：
   - 进入HACS > 集成
   - 点击右上角的三个点，选择"自定义仓库"
   - 添加URL `https://github.com/MagicStarTrace/xiaomi_cloud`，类别选择"Integration"
3. 在HACS中搜索"Xiaomi Cloud"并安装
4. 重启Home Assistant


### 手动安装

1. 下载最新版本
2. 解压并将`custom_components/xiaomi_cloud`目录复制到您Home Assistant的`custom_components`目录中
3. 重启Home Assistant

## 配置方法

1. 进入配置 > 集成
2. 点击"+"按钮添加新集成
3. 搜索"Xiaomi Cloud"并选择
4. 按照配置流程，输入您的小米账号凭据
5. 选择您希望使用的坐标系类型

注意：小米定位会有可能启用短信造成意外的费用[默认不启用]，日志会出现无法获取坐标

mars.z

很早之前用过另外一个大佬做的小米云的定位集成，但是频繁的定位，会扣话费   应该就是这个短信定位造成的扣费了

huyifanstar

mars.z 发表于 2025-5-23 12:57
很早之前用过另外一个大佬做的小米云的定位集成，但是频繁的定位，会扣话费   应该就是这个短信定位造成的 ...

短信扣费没启用

mars.z

huyifanstar 发表于 2025-5-23 13:04
短信扣费没启用

那不错，感谢大佬分享，已star

linyf

手机这个耗电量高么？

huyifanstar

linyf 发表于 2025-5-23 13:38
手机这个耗电量高么？

测了下还好，另外当监测到手机电量低于40% 会自动调整频率(自动调整为10分钟一次)

wwjw

感谢楼主分享。高德API是用“Web服务”还是“Web端”呢？

huyifanstar

wwjw 发表于 2025-5-23 17:18
感谢楼主分享。高德API是用“Web服务”还是“Web端”呢？

应用类型选择出行，然后在添加key那里选择 Web服务

nameyq

安装报错，大佬，定位精度大概有多少米啊。

huyifanstar

nameyq 发表于 2025-5-26 08:26
安装报错，大佬，定位精度大概有多少米啊。

忽略精度了