罗盘方位角的取值范围是0到360度，当我们需要计算两个方位角之间的最小夹角时，不能直接使用两个数值相减取绝对值的方式，因为方位角是循环的，比如350度和10度的差值直接算会得到340度，而实际最小夹角是20度。正确的计算逻辑需要先处理差值的循环特性，再取最小的结果。
计算原理说明
两个方位角angle1和angle2的最小夹角计算步骤如下：
- 第一步计算两个角度的直接差值，取绝对值
- 第二步判断这个差值是否大于180度，如果大于180度，说明实际最小夹角是360度减去这个差值
- 最终得到的结果就是两个方位角的最小夹角，范围在0到180度之间
PHP实现代码示例
下面是通用的PHP计算函数，包含参数校验和逻辑处理：
<?php
/**
* 计算两个罗盘方位角的最小夹角
* @param float $angle1 第一个方位角，范围0-360
* @param float $angle2 第二个方位角，范围0-360
* @return float 最小夹角，范围0-180
* @throws InvalidArgumentException 当方位角超出范围时抛出异常
*/
function calcMinCompassAngleDiff(float $angle1, float $angle2): float {
// 参数校验，确保方位角在0到360度之间
if ($angle1 < 0 || $angle1 > 360 || $angle2 < 0 || $angle2 > 360) {
throw new InvalidArgumentException('方位角必须在0到360度之间');
}
// 计算绝对差值
$diff = abs($angle1 - $angle2);
// 处理循环特性，取最小夹角
if ($diff > 180) {
return 360 - $diff;
}
return $diff;
}
// 测试用例
$testCases = [
[350, 10, 20],
[10, 350, 20],
[90, 180, 90],
[0, 180, 180],
[45, 45, 0],
[200, 300, 100],
];
foreach ($testCases as $case) {
$result = calcMinCompassAngleDiff($case[0], $case[1]);
$status = abs($result - $case[2]) < 0.0001 ? '通过' : '失败';
echo "测试{$case[0]}度和{$case[1]}度：预期{$case[2]}度，实际{$result}度，结果{$status}" . PHP_EOL;
}
?>
边界情况处理
实际使用中还需要注意一些特殊情况：
- 当输入方位角为0度和360度时，二者等价，计算得到的差值应为0度
- 如果输入的是浮点型方位角，比如10.5度和350.5度，函数同样可以正确计算，得到20度的结果
- 如果业务逻辑允许方位角超出0-360范围，比如输入了370度，可以先对360取模归一化到0-360区间再计算
方位角归一化函数
如果需要对超出范围的方位角做预处理，可以添加如下函数：
<?php
/**
* 将方位角归一化到0-360度区间
* @param float $angle 原始方位角
* @return float 归一化后的方位角
*/
function normalizeCompassAngle(float $angle): float {
$mod = fmod($angle, 360);
if ($mod < 0) {
$mod += 360;
}
return $mod;
}
// 使用示例：370度归一化后为10度
echo normalizeCompassAngle(370); // 输出10
?>
总结
罗盘方位角最小夹角计算的核心就是处理角度的循环特性，先算直接差值，再判断是否超过180度，超过就用360减差值。PHP实现时只要注意参数校验和归一化逻辑，就能得到准确的计算结果，避免常见的逻辑错误。