Flutter中如何获取范围为1-360度的Qibla朝向角度值

现有代码问题 #

• 语法缺失：var _angle = ((qiblahDirection.qiblah ?? 0) * (pi / 180) * -1 未闭合括号
• 无角度归一化：计算结果为带正负、范围失控的十进制值，不符合1-360要求
• 单位逻辑混乱：未明确原始qiblah参数的单位，直接乘pi/180易引发未定义错误

核心处理逻辑 #

Qibla标准方位角定义：从正北顺时针旋转的角度，要求取值1~360（0°等价于360°正北）

• 对原始度数做360取余，消除超过360的冗余角度
• 补正负数（负角度转正值）
• 归一化后为0°时强制转为360°，适配1~360的范围要求

修正后可直接使用的代码 #

场景1：需显示1-360°的度数文本（无需转弧度） #

// 获取原始Qibla参数（插件返回十进制度数）
final rawQibla = qiblahDirection?.qiblah ?? 0.0;
// 角度归一化到1~360
final standardAngle = rawQibla % 360 == 0 
    ? 360.0 
    : (rawQibla % 360 + 360) % 360;
var _angle = standardAngle;

场景2：需给Widget旋转用的弧度值（保留原代码的反转逻辑） #

import 'dart:math' as math; // 必须导入math库才能使用pi

final rawQibla = qiblahDirection?.qiblah ?? 0.0;
// 先归一化到1~360°
final standardDegree = rawQibla % 360 == 0 
    ? 360.0 
    : (rawQibla % 360 + 360) % 360;
// 转弧度+原代码的方向反转（若需调整方向可去掉*-1）
var _angle = standardDegree * (math.pi / 180) * -1;

关键说明 #

• 通用归一化公式：(rawValue % 360 + 360) % 360 可同时处理正、负、超360的所有角度值
• 原代码中直接使用pi会报错，必须通过import 'dart:math' as math; 引入后用math.pi

内容的提问来源于stack exchange，提问作者Muhamamad uzair