空间数据工作站 — 批量地理编码转换 & OSM 面域/POI 点位查询工具
Spatial Data Workstation — Batch Geocoding & OSM Polygon/POI Query Tool
- Search-First 智能引擎 / Search-First Engine — POI 文本搜索优先，信任高德原生排序，地名编码 API 作为兜底。无需手写质量判断逻辑。
- 多源地理编码 / Multi-source Geocoding — 高德地图、百度地图、OpenStreetMap（均已内置）
- 跨区域校验 / Cross-region Validation — 自动验证经纬度与地址省份/城市是否匹配
- 批量处理 / Batch Processing — 支持 CSV/Excel 大规模数据分批并发
- 智能重试 / Smart Retry — 失败自动重试，支持断点续传
- 一小时缓存 / Request Cache — 相同请求 1 小时内直接返回缓存结果
- 多候选选择 / Multi-candidate Selection — 高德返回多个结果时可选最佳匹配
- 自定义分类着色 / Custom Category Coloring — 按分类字段彩色标注坐标点
- 导出 GeoJSON / KML / CSV / PNG — 支持 QGIS / ArcGIS / Google Earth
- OpenStreetMap 面域查询 / OSM Polygon Query — 基于 Overpass API 查询建筑轮廓、城市功能区、行政边界
- POI 点位查询 / POI Point Query — 支持 OSM、高德、百度三套数据源
- OSM (Overpass API) — 查询 OSM node 数据，免费无 Key
- 高德 POI — 精细 POI 分类（官方分类代码），需高德 Web 服务 Key
- 百度 POI — 精细 POI 分类（v3 API），需百度浏览器端 AK
- 坐标自动转换 / Coordinate Auto-transform — 高德 GCJ-02 / 百度 BD-09 坐标自动转换为 WGS-84，确保与 GIS 软件无缝对接
- 语义搜索 / Semantic Search — 输入地名/POI/行政区名称，通过 Nominatim 定位后提取周边面域或 POI
- 矩形框选 / Two-Click Rectangle — 地图上点击两个对角顶点，自动成框并提取框内数据
- 多边形绘制 / Polygon Drawing — 自由绘制任意多边形，提取多边形内数据
- 国土分类着色 / LANDUSE_STANDARD_MAP — 60+ 分类条目，严格遵循国土空间制图规范（GB 标准）
- 行政边界 / Administrative Boundaries — 支持省/市/区县/街道四级行政区边界提取（admin_level 2/4/6/8）
- 统一导出 / Unified Export — CSV / GeoJSON / KML（POI 点位与面域数据可分别导出或合并导出）
- 7 种底图 / 7 Tile Layers — 高德、OpenStreetMap、Esri 卫星、高德卫星、天地图（街景/卫星）、CARTO 暗色
- 底图自动对齐 / Basemap Auto-alignment — 检测高德底图激活状态，WGS-84 数据自动转换为 GCJ-02，彻底消除 ~300-500m 坐标漂移
- 分类图例 / Category Legend — 按实际渲染颜色聚合显示，无冗余
- 自动聚焦 / Auto-fit — 查询结果自动缩放至所有坐标范围
- 实时进度条 / Real-time Progress — 显示处理进度、成功/失败计数
- 输入 / Input — 文本粘贴、CSV 上传、Excel 上传（.xlsx / .xls）
- 导出格式 / Export Formats — CSV / GeoJSON / KML / PNG 地图截图
npm install
npm run dev # 开发服务器 / Dev server → http://localhost:8083
npm run build # 构建生产版本 / Build for production
npm run release # 发布新版本（SemVer） / Release new version- 访问 高德开放平台控制台
- 创建 Web Service 类型 Key
- 无需配置域名绑定
- 访问 百度地图开放平台
- 创建浏览器端应用，复制 AK
免费使用，默认速率限制 1 次/秒
- 前端框架 / Frontend: React 18 + TypeScript
- 状态管理 / State Management: TanStack Query (React Query) v5 — 内置缓存、自动重试、后台同步
- 并行计算 / Parallel Computing: Web Workers — 离线解析海量 GeoJSON 数据，确保 UI 线程不卡死
- 架构模式 / Architecture: 策略模式 (Strategy Pattern) — 抽象 AMap, Baidu, OSM 独立服务模块
- 构建工具 / Build: Vite
- UI 组件 / UI: shadcn/ui (Radix UI)
- 地图库 / Map: Leaflet + leaflet-draw + leaflet.chinatmsproviders
- 坐标转换 / Coordinate Transform: gcoord（GCJ-02 / BD-09 ⇄ WGS-84）
- 样式 / Styling: Tailwind CSS
- 数据处理 / Data: PapaParse, XLSX
- 国际化 / i18n: i18next + react-i18next
- 动画 / Animation: Framer Motion
- 自动化发布 / Release: release-it + conventional-changelog + GitHub Actions
src/
├── services/ # 核心服务层 | Core Service Layer
│ ├── amap.ts # 高德地图服务 | Gaode/AMap Service
│ ├── baidu.ts # 百度地图服务 | Baidu Service
│ ├── osm.ts # OSM/Overpass 服务 | OSM/Overpass Service
│ ├── factory.ts # 服务工厂 | Service Factory
│ └── osmWorker.ts # OSM 数据解析 Worker | OSM Data Parser Worker
├── hooks/
│ ├── useGeocoding.ts # 坐标转换 Hook | Geocoding hook
│ └── useOverpassQuery.ts # 空间查询 Hook (React Query 封装) | Spatial query hook
├── components/
│ ├── GeoMap.tsx # 地图组件 | Map component
│ ├── GeocodingPanel.tsx # 坐标转换面板 | Geocoding panel
│ ├── AreaQueryPanel.tsx # 空间查询面板 | Spatial query panel
│ └── ResultsSection.tsx # 结果展示 | Results view
├── utils/
│ ├── geocoding.ts # 统一接口导出 | Unified API exports
│ └── coordTransform.ts # 坐标转换工具 | Coordinate transform
🔗 https://andyxu12341.github.io/Geocoding-China-Pro/
项目遵循 Conventional Commits 规范。
每次 push 到 main 分支将自动触发 GitHub Actions：
- 自动化版本号更新 (SemVer)
- 自动生成 CHANGELOG.md
- 自动创建 GitHub Release
npm run release # 手动触发发布流程
npm run release:dry # 预览发布效果MIT License