Flutter location包返回speed、speedAccuracy为-1如何获取有效速度值

云上老周

2026-8-28

-1返回值的具体含义

Flutter的location包在iOS端底层直接对接系统CoreLocation框架，speed、speedAccuracy返回-1是系统定义的无效值标识，代表当前定位模块无法生成可信的速度计算结果，不是插件本身的逻辑错误。
触发这个返回值的常见原因对应当前场景有三个：

测试环境限制：室内场景下GPS信号被建筑完全遮挡，系统定位只能依靠Wi-Fi、基站三角定位，这类定位方式的点位误差大、更新时间不稳定，不满足速度计算所需的连续高精度点位要求，系统直接返回无效值避免输出错误数据。
定位配置不足：如果没有申请到完整的定位使用权限、没有将定位精度调到导航级最高精度，iOS会主动降级定位服务能力，关闭速度计算相关的模块输出。
代码逻辑缺陷：当前代码每1毫秒就触发一次定位请求，且每次调用setLocation都会新建一个Location实例，既打断了系统定位的连续采样流程（速度计算需要至少2个连续时间差的有效点位才能算出结果），也没有全局生效的高精度配置，单次拉取定位的模式本身就很难拿到稳定的速度值。

获取有效正速度值的调整方法

按以下顺序调整即可拿到可信结果：

补全iOS端基础配置
打开项目下ios/Runner/Info.plist文件，添加定位权限描述字段：

<key>NSLocationWhenInUseUsageDescription</key>
<string>获取定位信息用于移动速度测量</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>获取定位信息用于移动速度测量</string>

全局初始化唯一的Location实例，不要在每次定位请求时重复创建，初始化时完成权限申请和精度配置：

// 全局声明唯一实例
final Location location = Location();
StreamSubscription<LocationData>? locationSub;

Future<void> _initLocation() async {
  // 申请定位权限
  final permissionStatus = await location.requestPermission();
  if (permissionStatus != PermissionStatus.granted && permissionStatus != PermissionStatus.grantedLimited) {
    return;
  }
  // 配置导航级最高精度，这是iOS端能稳定输出速度的必要配置
  await location.changeSettings(
    accuracy: LocationAccuracy.navigation,
    distanceFilter: 1, // 每移动1米触发一次位置更新
    interval: 1000, // 位置更新间隔1秒即可，无需毫秒级高频调用
  );
}

替换高频单次拉取逻辑为连续位置流监听
删掉定时器里调用setLocation、每次新建实例拉取定位的逻辑，改用系统提供的连续位置更新流，不会打断点位采样流程：

@override
void initState() {
  super.initState();
  restMilliSec = decideTimerTime(currentType) * 1000;
  // 初始化定位
  _initLocation().then((_) {
    locationSub = location.onLocationChanged.listen((position) {
      // 过滤无效值
      if (position.speed != null && position.speed! >= 0 && position.speedAccuracy >=0) {
        // 这里拿到的就是有效速度值，单位m/s
        print("当前速度：${position.speed}，速度精度误差：${position.speedAccuracy}");
      }
    });
  });
  // 原有定时器逻辑保留，移除里面的setLocation调用即可
  timer = Timer.periodic(const Duration(milliseconds: 1), (timer) async {
    // ... 原有其他逻辑 ...
    if (canVibrate) Vibrate.vibrate();
  });
}

// 页面销毁时释放资源，避免内存泄漏
@override
void dispose() {
  timer?.cancel();
  locationSub?.cancel();
  super.dispose();
}

调整测试场景
速度计算依赖连续的GPS卫星定位信号，室内环境无有效GPS信号时哪怕配置完全正确也无法拿到有效速度值。需要到开阔无遮挡的室外场地，等待3-5秒让GPS模块完成搜星，设备产生连续位移时就能拿到大于0的正速度值；设备静止状态下有效速度值为0属于正常情况。

补充说明：所有speed或speedAccuracy为-1的返回值都属于不可信数据，直接丢弃即可，不要用于业务计算。

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