#ifndef NMUTMPROJECTION_H #define NMUTMPROJECTION_H #include "nmData_global.h" #include // WGS84/UTM 坐标工具,不依赖 QWidget、分析管理器或当前工程。 // 经纬度统一使用十进制度,投影坐标统一使用米;显示单位由调用方交给框架换算。 namespace nmUtmProjection { // 检查有限经纬度及 UTM 覆盖范围:纬度 [-80, 84],经度 [-180, 180]。 NM_DATA_EXPORT bool isValidGeographic(double dLatitude, double dLongitude); // 检查有限米制坐标及基本范围:东向 [0, 1000000],北向 [0, 10000000]。 // 此检查不能代替反投影后的纬度范围检查。 NM_DATA_EXPORT bool isValidProjected(double dEasting, double dNorthing); // 解析两位经度带号和纬度带字母(如 50S);S 是纬度带,不表示南半球。 // 排除 32X/34X/36X 等不存在的自然分带;失败时调用方不得使用输出参数。 NM_DATA_EXPORT bool parseZone(const QString& sZone, int& nZone, char& cBand); // 将合法纬度(度)转换为 C~X 纬度带;纬度无效时返回 0,X 带包含北纬 84 度。 NM_DATA_EXPORT char latitudeBand(double dLatitude); // 格式化带号和字母,不改变投影坐标;基本字符或数值不合法时返回空串。 // 是否属于有效自然分带仍由 parseZone 检查。 NM_DATA_EXPORT QString zoneText(int nZone, char cBand); // 正投影:输入纬度/经度(度),输出自然分带和东向/北向(米)。 // 包含 Norway/Svalbard 特殊带宽及 +/-180 度边界;失败时不要使用输出参数。 NM_DATA_EXPORT bool geographicToUtm(double dLatitude, double dLongitude, QString& sZone, double& dEasting, double& dNorthing); // 反投影:按指定经度带及字母对应的半球解释米制坐标,输出纬度/经度(度)。 // 不按反算位置自动换成相邻自然带:模型偏移坐标必须继续使用参考点的投影带。 // 字母用于确定假北值,不限制结果仍处于原 8 度纬度带;超出半球/UTM 范围返回 false。 // 失败时不要使用输出参数,调用方应清空派生经纬度,避免保留上一次结果。 NM_DATA_EXPORT bool utmToGeographic(int nZone, char cBand, double dEasting, double dNorthing, double& dLatitude, double& dLongitude); // 返回有效自然分带覆盖区域的中心经纬度(度),供用户主动选带时初始化参考点。 // 特殊宽窄带使用覆盖区域中心;无效分带返回 false,不产生默认坐标。 NM_DATA_EXPORT bool zoneCenter(int nZone, char cBand, double& dLatitude, double& dLongitude); } #endif // NMUTMPROJECTION_H