GPSLogger

    此集成用于接入 GPSLogger。GPSLogger 是一款适用于 Android 的开源应用，可让用户在 Home Assistant 中更新自己的位置。

    配置

    要配置 GPSLogger，您必须先在配置页面的集成面板中完成设置。这样会得到一个 webhook URL，供后续移动设备配置时使用（见下文）。

    在智能手机上设置

    在您的设备上通过 GitHub 或 F-Droid 安装 Android 版 GPSLogger。

    启动后，进入 General Options。启用 Start on bootup 和 Start on app launch。

    GPSLogger Settings

    进入 Logging details，禁用 Log to GPX，并启用 Log to custom URL。

    Logging Details

    启用后，应用会立即带您进入 Log to custom URL 设置页面。

    Log to custom URL details

    相关端点以 /api/webhook/ 开头，并以一串唯一字符结尾。这个地址由配置页面中的集成面板提供（如上所述）。

    https://YOUR.DNS.HOSTNAME:PORT/api/webhook/WEBHOOK_ID
    • 将上面的 URL（把 YOUR.DNS.HOSTNAME:PORT 替换为您的实际信息）填入 URL 字段。
    • 强烈建议使用 SSL/TLS。
    • 使用 Home Assistant 在互联网上可访问的域名（如果您有静态 IP，也可以使用公网 IP 地址）。如果您的移动设备始终通过 VPN 连接到家庭网络，也可以使用本地 IP 地址。
    • 只有当您的 Home Assistant 实例使用 443 端口时，才删除 PORT；否则请填写您正在使用的端口。
    • 将以下内容填入 HTTP Body
    latitude=%LAT&longitude=%LON&device=%SER&accuracy=%ACC&battery=%BATT&speed=%SPD&direction=%DIR&altitude=%ALT&provider=%PROV&activity=%ACT
    • 您可以将 &device=%SER 替换为 &device=SOME_DEVICE_ID 来修改手机的 device_id；否则将使用您手机的序列号。
    • 检查 HTTP Headers 设置中包含以下内容
    Content-Type: application/x-www-form-urlencoded
    • 确保 HTTP Method 已改为 POST

    如果耗电过快，您可以在 Performance 中调整 GPSLogger 的性能设置。

    Performance

    您可以在应用中手动强制发送一次请求，以测试一切是否正常工作。