## 快速开始 ### 1. 注册账户 1. 访问应用地址 2. 点击 **Create account** 注册 3. 使用邮箱 `admin@lazycat.cloud` 注册将自动获得管理员权限 ### 2. 支持多种 app 搜集，以 Dawarich为例（iPhone） #### 支持的数据源 | 数据源 | 平台 | 同步方式 | |--------|------|---------| | **Dawarich** | iOS/Android | HTTP API | | **OwnTracks** | iOS/Android | HTTP/MQTT | | **Overland** | iOS | HTTP | | **GPSLogger** | Android | HTTP | | **Home Assistant** | 跨平台 | 集成 | 在 GeoPulse 中添加数据源后，需要在 Dawarich App 中配置服务器地址。 #### 步骤一：在 GeoPulse 创建 API Key 1. 登录 GeoPulse 2. 进入 **Location Data Sources** → **Add New Source** 3. 选择 **Dawarich** 4. 输入一个 API Key（自己设置，如：`my-secret-key-123`） 5. 点击 **Add Source** #### 步骤二：配置 Dawarich App 在 iPhone 上打开 Dawarich App，进入设置： | 配置项 | 值 | |--------|-----| | **Server URL** | `https://geopulse.lanmao168.heiyu.space/api/dawarich` | | **API Key** | 与 GeoPulse 中设置的相同（如 `my-secret-key-123`） | #### 步骤三：测试连接 1. 在 Dawarich App 中点击 **Test Connection** 或发送一次定位 2. 返回 GeoPulse 的 **GPS Data** 页面确认数据已接收 ## 主要功能 ### 📍 时间线 (Timeline) - 自动将 GPS 数据分类为停留点和行程 - 交互式地图显示移动轨迹 - 支持按日期范围查看 ### 📊 仪表盘 (Dashboard) - 行程距离统计 - 访问地点统计 - 活动数据分析 ### 🗺️ 地点管理 (Places) - 保存常用地点 - 自动地点识别 - 支持反向地理编码 ### 🔗 位置分享 - 实时位置分享（生成临时链接） - 历史行程分享 - 支持密码保护 ### 🤖 AI 助手（可选） - 自然语言查询位置数据 - 需要配置 OpenAI API Key ## 常见问题 ### 数据不显示？ - GPS 数据需要一定数量后才会生成时间线 - 检查 **GPS Data** 页面确认原始数据已接收 - 时间线生成可能需要几分钟 ### 地图加载失败（504 错误）？ 默认使用 OpenStreetMap 瓦片，在某些网络环境下可能无法访问。 **解决方案**：切换到国内地图源 1. 进入 **侧边栏菜单** → **Profile**（个人资料） 2. 找到 **Custom Map Tile URL** 字段 3. 输入国内地图瓦片地址（见下方推荐） 4. 保存并刷新页面 **推荐地图源**： 高德地图（免费，无需 key）： ``` https://webrd01.is.autonavi.com/appmaptile?lang=zh_cn&size=1&scale=1&style=8&x={x}&y={y}&z={z} ```