iOS设备Flutter Geolocator定位不准致地理围栏校验失败问题排查

问题背景 #

应用核心流程：

• 扫描二维码
• 获取用户当前位置
• 校验位置是否处于地理围栏内
• 符合条件则完成任务，否则提示「不在场」

当前iOS设备频繁误触发"不在场"提示，用户实际处于围栏内但校验不通过，Android设备无此问题。已排查：

• 开启设备精确定位
• 授予应用「始终允许」位置权限
• 重启设备、更新Geolocator包，问题仍存在

现有核心实现代码 #

位置校验主逻辑 #

void _verifyGeoScanWithLatLong(String scanResult) async {
  if (null == _userInfo.userInfoDetails!.site!.geofence ||
      _userInfo.userInfoDetails!.site!.geofence!.trim().isEmpty) {
    AppSnackBar.show('Site is not properly configured',
        icon: AppSnackBarIcon.SUCCESS);
    return;
  }

 _appProgressBar.showProgress();

// 获取用户当前位置
 final Position position = await Geolocator.getCurrentPosition(
      desiredAccuracy: LocationAccuracy.high);
// 解析围栏字符串为坐标点列表
  List<GeoPoint> fencingList =
      getPathFromPoly(_userInfo.userInfoDetails!.site!.geofence!);
// 校验位置是否在围栏内
  bool isWithinFencing = isPointInPolygon(
    GeoPoint(latitude: position.latitude, longitude: position.longitude),
    fencingList,
  );

  _appProgressBar.hideProgress();

  if (isWithinFencing) {
    _verifyNeoScanAndSubmitLocation(scanResult, position);
  } else {
    ConfirmationDialog.show(
      context,
      title: 'Scan Failed',
      description: 'You are off Site',
      positiveButtonText: 'Scan More',
      negativeButtonText: 'Done',
      isDismissible: false,
      onPositiveClick: () {
        Future.delayed(Duration.zero, () async {
          result = null;
          await controller?.resumeCamera();
        });
      },
      onNegativeClick: () {
        Future.delayed(Duration.zero, () {
          locator<NavigationService>().back();
        });
      },
    );
  }
}

围栏字符串解析方法 #

List<GeoPoint> getPathFromPoly(String polygon) {
  List<GeoPoint> geoList = [];

  var points = polygon.split('),(');
  points[0] = points[0].replaceAll('(', '');
  final length = points.length - 1;
  points[length] = points[length].replaceAll(')', '');

  for (int i = 0; i < points.length; i++) {
    var latLng = points[i].split(',');
    GeoPoint geoPoint = GeoPoint(
        latitude: double.parse(latLng[0]), longitude: double.parse(latLng[1]));
    geoList.add(geoPoint);
  }

  return geoList;
}

点-in-多边形校验方法 #

bool isPointInPolygon(GeoPoint tap, List<GeoPoint> vertices) {
  var intersectCount = 0;
  for (int i = 0; i < vertices.length - 1; i++) {
    if (_rayCastIntersect(tap, vertices[i], vertices[i + 1])) {
      intersectCount++;
    }
  }
  return ((intersectCount % 2) == 1); // 奇数=内部，偶数=外部
}

bool _rayCastIntersect(GeoPoint tap, GeoPoint vertA, GeoPoint vertB) {
  final aY = vertA.latitude;
  final bY = vertB.latitude;
  final aX = vertA.longitude;
  final bX = vertB.longitude;
  final pY = tap.latitude;
  final pX = tap.longitude;

  if (aY > pY && bY > pY || aY < pY && bY < pY || aX < pX && bX < pX) {
    return false;
    // 两点不能同时在点的Y轴同侧，且至少一点在点的X轴右侧
  }
  final m = (aY - bY) / (aX - bX); // 斜率
  final bee = -aX * m + aY; // 截距
  final x = (pY - bee) / m; // 交点X坐标
  return x > pX;
}

iOS端精准适配方案 #

1. 优化位置获取逻辑，适配iOS定位特性 #

iOS的getCurrentPosition在冷启动、室内场景下可能返回缓存低精度位置，或因系统限制延迟返回。修改位置获取逻辑：

final Position position;
try {
  // 优先请求实时高精度位置，设置10秒超时
  position = await Geolocator.getCurrentPosition(
    desiredAccuracy: LocationAccuracy.best,
    timeLimit: const Duration(seconds: 10),
  );
} catch (e) {
  // 超时或失败时，获取30秒内的缓存位置
  final lastPosition = await Geolocator.getLastKnownPosition();
  if (lastPosition == null) {
    AppSnackBar.show('无法获取位置，请检查定位设置');
    _appProgressBar.hideProgress();
    return;
  }
  position = lastPosition;
}

2. 修复点-in-多边形算法的精度与逻辑问题 #

（1）添加浮点容差，处理iOS定位精度误差

iOS定位返回的坐标小数位更多，容易因浮点精度导致误判：

const double tolerance = 1e-6; // 浮点容差

bool _rayCastIntersect(GeoPoint tap, GeoPoint vertA, GeoPoint vertB) {
  final aY = vertA.latitude;
  final bY = vertB.latitude;
  final aX = vertA.longitude;
  final bX = vertB.longitude;
  final pY = tap.latitude;
  final pX = tap.longitude;

  // 处理点与边Y轴重合的情况
  if ((aY - pY).abs() < tolerance) aY = pY;
  if ((bY - pY).abs() < tolerance) bY = pY;

  // 增加容差判断，避免精度误判
  if ((aY > pY + tolerance && bY > pY + tolerance) || 
      (aY < pY - tolerance && bY < pY - tolerance) || 
      (aX < pX - tolerance && bX < pX - tolerance)) {
    return false;
  }

  // 处理垂直边（分母为0）的情况
  if ((aX - bX).abs() < tolerance) {
    return aX > pX + tolerance;
  }

  final m = (aY - bY) / (aX - bX);
  final bee = -aX * m + aY;
  final x = (pY - bee) / m;

  return x > pX + tolerance;
}

（2）闭合多边形的最后一条边

现有算法未处理最后一个点到第一个点的闭合边，导致围栏不完整：

bool isPointInPolygon(GeoPoint tap, List<GeoPoint> vertices) {
  if (vertices.length < 3) return false; // 至少3个点构成多边形
  var intersectCount = 0;
  for (int i = 0; i < vertices.length; i++) {
    GeoPoint vertA = vertices[i];
    GeoPoint vertB = vertices[(i + 1) % vertices.length]; // 闭合最后一条边
    if (_rayCastIntersect(tap, vertA, vertB)) {
      intersectCount++;
    }
  }
  return (intersectCount % 2) == 1;
}

3. 完善iOS定位权限配置 #

iOS 14+对高精度定位有额外限制，需补充配置：

• 在Info.plist中添加权限描述：

  <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
  <string>需要获取您的位置以验证是否在指定区域内</string>
  <key>NSLocationWhenInUseUsageDescription</key>
  <string>需要获取您的位置以验证是否在指定区域内</string>
  <key>NSLocationTemporaryUsageDescriptionDictionary</key>
  <dict>
    <key>LocationAccuracyAuthorization</key>
    <string>需要高精度定位以准确验证您的位置</string>
  </dict>
  

• 初始化时请求临时高精度授权：

  await Geolocator.requestTemporaryFullAccuracy(
    purposeKey: "LocationAccuracyAuthorization",
  );
  

4. 添加日志调试，定位具体误差 #

在iOS设备上打印详细日志，方便定位坐标偏差：

// 获取位置后打印
print("iOS定位结果：纬度=${position.latitude}, 经度=${position.longitude}");
// 打印围栏坐标
print("围栏坐标：${fencingList.map((p) => '(${p.latitude},${p.longitude})').join(',')}");
// 打印校验结果
print("是否在围栏内：$isWithinFencing");

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