# phone-tracker

**Repository Path**: PhiloKun/phone-tracker

## Basic Information

- **Project Name**: phone-tracker
- **Description**: Real-time phone GPS location tracking
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-04
- **Last Updated**: 2026-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Phone Tracker 📍

实时手机位置追踪应用。手机打开页面即可上报 GPS 位置，在电脑上通过地图实时查看。

## 快速开始

```bash
npm install
npm start
```

## 访问地址

| 页面 | 说明 | 地址 |
|------|------|------|
| **Dashboard** | 地图看板，实时查看所有设备位置 | `http://localhost:3000/` |
| **Track 页面** | 手机打开此页面上报位置 | `http://localhost:3000/track.html` |

## 使用流程

1. **启动服务**：`npm start`
2. **电脑端**：浏览器打开 Dashboard 页面
3. **手机端**：在同一局域网或公网，用手机浏览器打开 Track 页面
4. 在手机上点击 **「🔴 开始追踪」**，允许定位权限
5. Dashboard 上会实时显示手机位置和移动轨迹

## 功能特性

- 实时 GPS 定位追踪（WebSocket 推送）
- 多设备同时追踪
- 移动轨迹记录与显示
- 设备信息展示（经纬度、精度、速度、方向、电量）
- 在线/离线状态检测（30 秒无更新判定离线）
- REST API 获取设备数据与历史轨迹

## API

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/devices` | 获取所有设备最新位置 |
| GET | `/api/devices/:id/history` | 获取指定设备历史轨迹 |

## 局域网共享

同一局域网内的其他设备访问 `http://<你的局域网IP>:3000` 即可。

> **注意**：手机端使用浏览器定位精度不如原生 App，建议在室外开阔处使用。