# 地图采集工具

**Repository Path**: yangziqing/map-collection-tool

## Basic Information

- **Project Name**: 地图采集工具
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-27
- **Last Updated**: 2025-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PathTracker 项目说明文档

## 项目简介
PathTracker 是一款基于 Android 平台的路径追踪与地图标记应用，主要功能包括路径记录、地图概览、离线地图下载以及点位标记。它使用高德地图 SDK 实现地图功能，并通过网络请求与后端服务进行数据交互。

## 主要功能
- **路径追踪**：记录用户的移动路径，并支持上传至服务器。
- **地图概览**：展示所有已记录的路径和标记点。
- **离线地图**：支持下载特定城市的离线地图数据。
- **点位标记**：允许用户在地图上标记重要位置，并可上传或管理这些标记。

## 技术栈
- **编程语言**：Kotlin
- **地图 SDK**：高德地图
- **网络请求**：Retrofit + OkHttp
- **数据存储**：SharedPreferences (通过 SPUtils 工具类)
- **架构组件**：Android Jetpack 组件 (如 ViewModel, LiveData)

## 核心模块
- **Activity**
  - `LoginActivity`：登录界面
  - `MainActivity`：主界面，包含导航逻辑
  - `MapActivity`：路径追踪界面
  - `MapOverviewActivity`：地图概览界面
  - `OfflineMapActivity`：离线地图下载管理
  - `PointMarkActivity`：点位标记管理

- **Bean 类**
  - `MapPoint`：地图标记点数据模型
  - `PathData`：路径数据模型
  - `PathTypeData`：路径类型数据模型
  - `PointTypeData`：点位类型数据模型
  - `UploadResponse`：网络请求响应封装

- **网络模块**
  - `ApiService`：定义所有网络请求接口
  - `RetrofitClient`：Retrofit 客户端封装

- **工具类**
  - `BatteryOptimizationUtils`：电池优化相关工具
  - `LocationManager`：位置管理工具
  - `LocationUtils`：位置计算工具
  - `NetworkUtils`：网络状态检测工具
  - `SPUtils`：SharedPreferences 工具类

## 使用说明
1. **启动应用**
   - 打开应用后，首先会进入登录界面 (`LoginActivity`)
   - 登录成功后进入主界面 (`MainActivity`)

2. **路径追踪**
   - 在主界面点击“开始追踪”进入 `MapActivity`
   - 应用会实时记录您的位置并绘制路径
   - 可选择路径类型、保存路径或上传至服务器

3. **地图概览**
   - 在主界面点击“地图概览”进入 `MapOverviewActivity`
   - 查看所有已记录的路径和标记点
   - 支持点击标记查看详细信息

4. **离线地图**
   - 在主界面点击“离线地图”进入 `OfflineMapActivity`
   - 下载浙江省各城市离线地图数据
   - 支持暂停、删除和更新检查

5. **点位标记**
   - 在主界面点击“标记点”进入 `PointMarkActivity`
   - 长按地图添加新标记
   - 可编辑、删除或上传标记点

## 贡献指南
欢迎贡献代码！请遵循以下步骤：
1. Fork 本仓库
2. 创建新分支 (`git checkout -b feature/your-feature-name`)
3. 提交更改 (`git commit -am 'Add some feature'`)
4. 推送分支 (`git push origin feature/your-feature-name`)
5. 创建 Pull Request

## 许可证
本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。