# 测绘工具箱 (geo-tools)

面向测绘与 GIS 日常工作的纯前端工具集，基于 Vue 3 + Vite 构建。支持坐标转换、距离/面积/方位角/高程计算、高德地名搜索、图上量测拾取与坐标展点。

## 功能列表

| 工具 | 说明 |
|------|------|
| 坐标转换 | 度分秒与十进制互转、WGS84/GCJ-02 等坐标系转换、CGCS2000 高斯投影正反算，支持 Excel 批量 |
| 距离计算 | 经纬度 Haversine 与平面坐标距离 |
| 面积计算 | 多边形面积/周长，支持大地测量与平面算法 |
| 角度转换 | 度分秒、十进制度、弧度互转 |
| 方位角计算 | 方位角与象限角 |
| 高程计算 | 高差、坡度、坡度角、斜距/水平距换算 |
| 高德地名搜索 | 通过高德 Web 服务搜索 POI，导出 TXT/CSV |
| 图上量测与拾取 | Leaflet 地图点选、量距、量面，显示 WGS-84 与投影坐标 |
| 坐标展点 | 手动/批量/Excel 导入坐标并展绘到地图 |

## 技术栈

- Vue 3 + Vue Router + Vite
- Leaflet（地图）、proj4 / gcoord（投影与坐标系）、Turf 子包（面积/长度）
- ExcelJS（Excel 读写）
- Vitest + ESLint + Prettier

## 本地开发

```bash
npm install
npm run dev
```

默认开发地址：`http://localhost:5173/geo-tools/`（已配置 `base: '/geo-tools/'`）。

## 常用脚本

```bash
npm run dev      # 开发服务器
npm run build    # 生产构建
npm run preview  # 预览构建结果
npm run test     # 单元测试
npm run lint     # ESLint 检查
```

## 部署说明

项目构建产物默认部署在子路径 `/geo-tools/` 下（见 `vite.config.js` 的 `base` 与路由 `createWebHistory('/geo-tools/')`）。

常见部署方式：

1. 将 `npm run build` 生成的 `dist/` 上传到静态站点对应子目录（如 GitHub Pages 的 `/geo-tools/`）
2. 若部署到站点根路径，需同步把 `base` 与路由器 history base 改为 `'/'`

### 注意事项

- **高德瓦片**：图上量测与坐标展点使用的高德栅格瓦片为非官方接口，公开长期部署时建议改为天地图等正规授权底图，或自行申请合规底图服务。
- **高德 Web API Key**：地名搜索功能的 Key 保存在浏览器 `localStorage`。公开使用前请在高德控制台配置域名白名单与配额限制。
- 坐标转换与投影计算在浏览器本地完成，不上传坐标数据到自建后端。

## 目录结构（简要）

```
src/
  views/          # 路由页面
  composables/    # useLeafletMap、useToast 等
  utils/          # 坐标、投影、几何、Excel 等纯函数
  assets/css/     # 全局样式与主题变量
```

## License

Private / 按项目需要自行约定。