坐标高程批量查询工具 · CoordElev

CoordElev — Coordinate and Elevation Batch Query Tool

一款面向通信勘察、站址规划和 GIS 数据处理人员的 Windows 桌面工具。支持单点地址/坐标查询、Excel/CSV 批量查询、GCJ-02 与 WGS-84 转换，以及在线和本地 SRTM HGT 离线高程查询。

A Windows desktop utility for coordinate conversion and elevation lookup. It supports single-point and Excel/CSV batch queries, online elevation services, and local SRTM HGT tiles.

界面语言 / UI Language：简体中文（Simplified Chinese only）。

✨ 主要功能 / Features

• 单点查询 Single Point：地址（高德地理编码）或经纬度查询高程。
• 批量在线 Batch Online：导入 Excel/CSV，默认使用 Open-Meteo，失败可回落 Open-Elevation。
• 批量离线 Batch Offline：使用本地 SRTM .hgt 瓦片，支持 1201×1201 和 3601×3601。
• 坐标转换 Coordinate Conversion：GCJ-02 ↔ WGS-84。
• 高程插值 Elevation Interpolation：离线双线性插值与 HGT 瓦片 LRU 缓存。
• 结果导出 Export：导出 Excel/CSV，并可导出缺失瓦片清单。
• 稳定性 Reliability：越界/非有限坐标校验、配置原子写入、后台线程安全关闭。

🚀 快速开始 / Quick Start

1. 从 Releases 下载 CoordElev V1.0。
2. 解压后双击 EXE，无需安装 Python（Windows 10/11 x64）。
3. 在“全局设置”中配置高德 Key（地址查询需要）和离线 HGT 目录。
4. 选择单点、批量在线或批量离线模式查询并导出结果。

完整操作说明见 使用说明书。

📋 批量数据要求 / Batch Data

• 支持 .xlsx、.xls 和 .csv。
• 表头须包含经度/纬度，也支持 lon、lng、longitude、lat、latitude。
• 经度范围为 -180～180，纬度范围为 -90～90，坐标使用十进制度。
• CSV 支持 UTF-8、GBK 和 GB18030 常用编码。

🧪 开发与构建 / Development

cd /d <CoordElev 源码目录>
python -m venv .venv
.venv\Scripts\python -m pip install -r requirements.txt

set QT_QPA_PLATFORM=offscreen
.venv\Scripts\python main.py --self-test

powershell -ExecutionPolicy Bypass -File build_release.ps1

构建产物位于 dist_release，ZIP 内仅包含同名 EXE。

🏗️ 技术栈 / Tech Stack

Python 3.12 · PySide6 · pandas · openpyxl · cryptography

在线高程服务与高德地理编码受各自服务条款、配额及网络状态影响。查询结果仅供工程辅助参考，不能替代正式测绘成果。

📄 许可证 / License

本项目采用 CC BY-NC 4.0（署名-非商业性使用） 许可协议。

• ✅ 可自由查看、下载、修改、分享源码
• ✅ 使用时须保留作者署名
• ❌ 禁止商业用途（销售、集成到收费产品、有偿服务需单独商业授权）

This project is licensed under CC BY-NC 4.0 (Attribution-NonCommercial). Free for personal/non-commercial use. Commercial use requires a separate license.

📞 联系方式 / Contact

• 作者 Author：通信民工（Jerry Xu）
• 哔哩哔哩 Bilibili：@通信民工（UID：482597398）
• 微信公众号 WeChat：@通信民工（ComDesigner）
• QQ：853665220（@qq.com）
• 网站 Website：http://www.txmg.com
• 著作 Book：《5G网络规划与工程实践》（清华大学出版社出版，当当、京东、淘宝等平台均可购买）

微信公众号二维码 / WeChat QR Code

扫描下方二维码关注微信公众号“通信民工（ComDesigner）”。

Scan the QR code below to follow the WeChat official account “通信民工（ComDesigner）”.