什么是OwnTracks Location
OwnTracks Location 是一个基于 OwnTracks 应用与 HTTP Webhook 的实时位置追踪系统，通过手机发送的位置数据自动更新本地 SQLite 数据库，并对外提供简洁的 RESTful API。该系统专为智能家居或个人自动化场景设计，能够持续接收来自 Android 和 iOS 设备的 GPS 坐标信息，包括精度、电量、时间戳等元数据。所有数据以 JSON 格式存储于本地文件系统中，支持持久化运行，非常适合部署在家庭服务器或树莓派等设备上。用户可通过命令行工具或简单的 HTTP 请求查询最新位置状态，实现‘我在哪里？’这类自然语言指令的快速响应。
整个架构由三部分构成：手机端运行的 OwnTracks 客户端负责采集并推送位置信息；Node.js 编写的 server.mjs 作为接收端监听指定端口，解析 POST 请求并将有效数据写入 SQLite；最后通过 places.mjs 脚本提供命名地点管理和地理距离计算功能。系统默认使用端口 18793，可通过环境变量灵活调整数据存储路径和网络接口。为确保稳定性，推荐配置为 systemd 用户服务长期运行。由于依赖 Tailscale 或局域网连通性，建议在同一可信网络环境下部署以保证通信安全。
除了基础的位置记录外，该方案还支持自定义地点标记——例如将当前位置命名为‘健身房’或‘办公室’，并通过 haversine 公式计算与这些预设点的距离。这使得它不仅适用于被动监控，还能主动响应用户指令，比如回答‘我离家还有多远？’或‘附近有哪些咖啡店？’。整体实现轻量、开源且无需第三方云服务，完全掌控用户隐私数据。
核心功能特点
- 实时接收 OwnTracks 应用推送的手机 GPS 位置数据
- 支持 SQLite 本地存储及持久化运行
- 提供 /latest 和 /history 等标准 HTTP API 接口
- 内置命名地点管理与基于距离的查询功能
- 可通过 CLI 或 curl 快速获取当前位置信息
- 兼容 Tailscale 组网，保障跨网络安全通信
适用场景
OwnTracks Location 最典型的应用场景是满足用户对自身位置的即时询问，例如当用户在家中突然想知道‘我现在在哪儿？’时，只需向系统发出指令即可获得当前经纬度、精度误差、设备电量等详细信息。这种能力源于系统持续监听来自手机的 POST 请求，并将最新数据包保存至本地数据库，确保响应速度极快且无需联网查询外部地图服务。此外，它特别适合需要自动化触发其他智能设备的情境，比如检测到用户接近家门时自动开启灯光或启动咖啡机。
另一个高频使用场景是建立个人地理围栏（Geofencing）。用户可以在系统中预先添加多个重要地点，如‘家’、‘公司’、‘健身房’，随后通过命令查询自己距离这些地点的具体公里数。这不仅可用于日常通勤规划，还能结合 Home Assistant 或其他 IoT 平台实现条件化操作。例如设定当距离健身房小于 500 米时发送通知提醒准备运动装备。对于经常出差或旅行的人来说，该系统同样实用——只需在到达新城市后说一句‘这里是我的酒店’，系统便会记住该坐标，后续可随时回顾行程轨迹或对比不同城市的停留点。
更进阶的应用涉及历史数据分析。虽然本工具主要聚焦实时位置而非长期趋势，但通过调用 /history 接口可回溯最近若干次上报记录，辅助判断出行规律或验证某段时间内的活动范围。配合 Nominatim 反向地理编码服务，还能将原始坐标转换为可读地址，提升用户体验。总体而言，OwnTracks Location 构建了一个低成本、高可控性的个人位置感知基础设施，既避免了商业定位服务的隐私风险，又超越了简单日志记录的局限性，真正实现了‘有问必答’的主动式位置管理。