磁偏角（Magnetic Declination）是磁北方向与真北方向之间的夹角。由于磁北与真北并不完全重合，使用磁罗盘、磁传感器等设备测得的磁方位角，在采用真北作为方位基准的工程应用中，需要结合当地磁偏角换算为真方位角。磁偏角常用于煤矿定向钻孔、煤矿随钻测量、矿山测量、地质调查、工程测量、罗盘校正和导航方向修正等场景。

磁偏角可以用东偏和西偏表示方向。在本工具的计算和显示约定中，东偏记为正值（+），西偏记为负值（-）。例如东偏2.8°表示磁偏角为+2.8°，西偏2.8°表示磁偏角为-2.8°。进行磁方位与真方位换算时，可以直接使用磁偏角的带符号数值进行计算。

会。地球磁场会随时间发生变化，因此同一个地点在不同日期的磁偏角可能不同。进行煤矿定向钻孔、随钻测量、矿山测量或其他工程计算时，应根据实际作业时间查询相应日期的磁偏角，不宜长期使用历史磁偏角数值。

在本工具采用的符号约定下：真方位角 = 磁方位角 + 磁偏角，其中东偏为正（+），西偏为负（-）。例如磁方位角为120°，磁偏角为+3.5°（东偏3.5°），则真方位角为123.5°；如果磁偏角为-3.5°（西偏3.5°），则真方位角为116.5°。反向换算时：磁方位角 = 真方位角 - 磁偏角。

煤矿随钻测量（MWD）系统使用磁传感器测得的方位，通常以地磁北为参考，属于磁方位角。进行钻孔轨迹计算前，应先确认测量系统输出的是磁方位、真方位还是网格方位，并确认项目采用的方位基准。在本工具的符号约定下，东偏为正、西偏为负，真方位角 = 磁方位角 + 磁偏角。例如磁方位角为125°、当地磁偏角为-4°（西偏4°）时，换算真方位角为121°。修正时还应统一测量日期、钻孔位置和海拔条件，并记录模型名称、坐标基准与计算结果，避免把磁偏角重复修正或漏修正。

定向钻孔轨迹计算首先要统一方位基准、坐标系和高程基准。若设计方位采用真北，而现场仪器或随钻系统输出磁方位，应在每个测量位置使用对应日期和位置的磁偏角进行换算，再将修正后的方位输入轨迹计算流程。磁偏角符号必须与项目约定一致：本工具中东偏为正、西偏为负，真方位角 = 磁方位角 + 磁偏角。工程记录建议同时保存原始磁方位、磁偏角、修正后方位、坐标、日期、海拔和模型名称；计算结果还应结合仪器校准、钻具磁干扰、井下环境和项目测量规范进行复核，不能仅凭模型值替代现场检查。

磁偏角查询结果可以作为工程设计、现场记录和内部技术复核的参考数据。用于正式测量成果、煤矿安全技术资料或工程交付文件时，还应结合项目采用的坐标基准、方位基准、测量规范、仪器校准情况以及现场技术要求进行确认。

书玉磁偏角查询工具重点面向中国境内的工程和测量应用，可用于煤矿定向钻孔、煤矿随钻测量、煤矿巷道与矿区测量、地质调查、工程定位、罗盘校正以及其他需要进行磁方位与真方位转换的场景。工具支持地点、经纬度和地图选点查询，适合工程设计、现场作业和技术资料查询使用。

煤矿定向钻孔设计通常需要统一钻孔的方位基准。当现场使用磁传感器测量钻孔方位时，获得的方位通常以地磁北方向为参考，即磁方位角。如果钻孔设计采用真北方位，则需要利用当地磁偏角将磁方位角转换为真方位角。磁偏角设置不正确，会形成系统性的方位偏差，并随着钻孔长度增加表现为更明显的平面轨迹偏移，因此磁偏角是煤矿定向钻孔方位测量和轨迹计算中的重要基础参数。

对于使用磁传感器的煤矿随钻测量系统（MWD），测得的钻孔方位通常以地磁北方向为参考，属于磁方位角；而煤矿钻孔设计和轨迹计算通常需要使用统一的工程方位基准。如果钻孔设计采用真北方位，就需要利用当地磁偏角将磁方位角修正为真方位角。在本工具采用的符号约定下：真方位角 = 磁方位角 + 磁偏角，其中东偏为正，西偏为负。例如随钻测量系统测得磁方位角为125°，当地磁偏角为-4°，则修正后的真方位角为121°。正确设置磁偏角有助于减少钻孔轨迹在平面方向上的系统性方位偏差。

可以通过地点搜索、输入经纬度或地图选点确定查询位置，并根据需要设置查询日期和海拔等参数。系统根据输入的位置、日期和高度计算当地地磁参数，可输出磁偏角、磁倾角和磁场总强度等结果。对于工程应用，建议使用实际作业位置的经纬度和对应作业日期进行查询。

WMMHR2025（World Magnetic Model High Resolution 2025）是一种高分辨率世界磁场模型，可用于计算磁偏角、磁倾角和磁场强度等地磁参数。书玉磁偏角查询工具将相关模型文件部署在服务端，并在服务器完成地磁参数计算，从而减少计算过程对外部接口的依赖，适合磁偏角查询及工程技术应用。

WMM2025 是标准世界磁场模型，适合全球尺度的导航、航向参考和一般地磁参数计算；WMMHR2025 是面向更高空间分辨率的扩展模型，在保留 WMM2025 低阶主磁场和长期变化信息的基础上，引入更高阶的地磁场与地壳磁场细节。两者的差异主要体现在空间细节表现，不代表 WMMHR2025 可以消除矿井、钻孔附近的局部磁干扰。本工具采用 WMMHR2025，适合中国境内磁偏角查询、矿山测绘和工程方位复核；实际作业仍应结合坐标基准、查询日期、仪器校准和现场磁干扰检查。