小米云集成 (Xiaomi Cloud Integration) for Home Assistant
Home Assistant自定义组件，用于小米云服务集成
该自定义组件通过连接小米云服务，将您的小米设备坐标地址集成到Home Assistant中。
前置
自己去申请高德API KEY https://lbs.amap.com/
应用类型选择出行，然后在添加key那里选择 Web服务
功能特点
- 连接小米云账户（小米/米家）
- 提供支持设备的位置追踪功能
- 从兼容的小米设备获取传感器数据
GPS定位功能
位置追踪细节
本组件利用小米云服务的"查找设备"功能来获取设备的实时位置信息。工作原理如下：
- 周期性定位更新：组件每3分钟自动发送"查找设备"命令到小米云服务，触发设备进行定位
- 坐标系转换：支持多种坐标系格式，可在配置时选择
- 原始坐标（original）：设备返回的原始坐标
- 国测局坐标（GCJ02）：适用于大部分中国地图服务
- WGS84坐标：全球GPS标准坐标系，适用于国际地图服务
位置数据属性
位置追踪实体提供以下属性：
- 经纬度：设备的地理位置坐标
- 精度：位置数据的精确度（以米为单位）
- 最后更新时间：设备位置信息的最后更新时间
- 电量：设备的电池电量百分比（如果设备支持）
坐标系选择
在集成配置过程中，您可以选择希望使用的坐标系类型：
- original：设备原始上报的坐标系
- WGS84：全球GPS标准坐标系，适用于国际地图服务
- GCJ02：国测局坐标系，适用于中国大陆地图服务
选择正确的坐标系对于准确显示设备在地图上的位置至关重要。
安装方法
使用HACS安装（推荐）
- 确保您的Home Assistant已安装HACS
- 在HACS中添加此仓库作为自定义仓库：
- 进入HACS > 集成
- 点击右上角的三个点，选择"自定义仓库"
- 添加URL
https://github.com/MagicStarTrace/xiaomi_cloud，类别选择"Integration"
- 在HACS中搜索"Xiaomi Cloud"并安装
- 重启Home Assistant
手动安装
- 下载最新版本
- 解压并将
custom_components/xiaomi_cloud目录复制到您Home Assistant的custom_components目录中
- 重启Home Assistant
配置方法
- 进入配置 > 集成
- 点击"+"按钮添加新集成
- 搜索"Xiaomi Cloud"并选择
- 按照配置流程，输入您的小米账号凭据
- 选择您希望使用的坐标系类型
注意：小米定位会有可能启用短信造成意外的费用[默认不启用]，日志会出现无法获取坐标
| 
发表于 2025-5-23 12:02:50
应该就是这个短信定位造成的扣费了
