flutter获取地理定位：geolocator依赖详细用法

 本文使用geolocator插件实现app物理定位功能。

该插件的主要功能有：

• 获取最后已知位置；
• 获取设备当前位置；
• 获取连续的位置更新；
• 检查设备是否启用了定位服务；
• 计算两个地理坐标之间的距离（米）；
• 计算两个地理坐标之间的方位；

  如何安装：

   方法一：在pubspec.yaml文件中添加它，10.1.0是当前最新版本号，也可指定特定版本号。

  然后在终端运行以下命令：

  flutter packages get

  方法二：直接在终端运行以下命令获取最新版本geolocator插件

  flutter pub add geolocator

  配置app环境 ：

  Android系统

  1.在 "android\gradle.properties" 文件中添加以下内容：

  android.useAndroidX=trueandroid.enableJetifier=true

  2.确保将 "android/app/build.gradle "文件中的 compileSdkVersion 设置为 33(10.1.0版本时要求，不同版本可能要求不一样，具体看原依赖文档)：

  android {  compileSdkVersion 33  ...}

  3.确保将所有 android. 依赖项替换为 AndroidX 对应项（完整列表可在此处找到：迁移到 AndroidX）。

  4.打开 "android\app\src\main\AndroidManifest.xml" 文件，将以下两行中的一行添加为 标签的直接子代（当这两种权限都配置时，geolocator将使用 ACCESS_FINE_LOCATION）：

  如果你目标用户用的是Android10或者以上的系统，就需要再添加ACCESS_BACKGROUND_LOCATION这条权限

  IOS系统

  打开 "ios\Runner\Info.plist" 文件，添加以下内容。string标签内为描述，可更改以贴合上下文。

  NSLocationWhenInUseUsageDescriptionThis app needs access to location when open.NSLocationAlwaysUsageDescriptionThis app needs access to location when in the background.

  如果你想在应用程序处于后台时也能接收位置更新，你还需要在 XCode 项目中添加后台模式功能（项目 > 签名和功能 > "+ 功能 "按钮）并选择位置更新。（但要注意，在向 AppStore 提交应用程序时，你需要向苹果公司详细解释为什么您的应用程序需要这样做。如果苹果不满意您的解释，您的应用程序将被拒绝。）

  使用 requestTemporaryFullAccuracy({purposeKey: "YourPurposeKey"}) 方法时，应在 Info.plist 文件中添加一个字典。第二个键（本例中称为 YourPurposeKey）应与 requestTemporaryFullAccuracy() 方法中传递的 purposeKey 相匹配

  NSLocationTemporaryUsageDescriptionDictionary  YourPurposeKey  The example App requires temporary access to the device's precise location.

  简单使用举例：

  权限配置完成后我们就可以开始使用地理定位依赖了，下面的代码举例说明了如何获取设备的当前位置，包括检查定位服务是否启用，以及检查/请求访问设备位置的权限：

  /// 位置服务  Future _determinePosition() async {    bool serviceEnabled;    LocationPermission permission;    double longitude=0;    double latitude=0;    try {      /// 手机GPS服务是否已启用。      serviceEnabled = await Geolocator.isLocationServiceEnabled();      if (!serviceEnabled) {        //定位服务未启用，要求用户启用定位服务        var res = await Geolocator.openLocationSettings();        if (!res) {          /// 被拒绝          return;        }      }      /// 是否允许app访问地理位置      permission = await Geolocator.checkPermission();      if (permission == LocationPermission.denied) {        /// 之前访问设备位置的权限被拒绝，重新申请权限        permission = await Geolocator.requestPermission();        if (permission == LocationPermission.denied || permission == LocationPermission.deniedForever) {          /// 再次被拒绝。根据Android指南，你的应用现在应该显示一个解释性UI。          return;        }      } else if (permission == LocationPermission.deniedForever) {        /// 之前权限被永久拒绝，打开app权限设置页面        await Geolocator.openAppSettings();        return;      }      /// 允许访问地理位置，获取地理位置      Position position = await Geolocator.getCurrentPosition();      longitude = position.longitude;      latitude = position.latitude;    } catch (e) {      print(e);    }  }   

  geolocator依赖的完整API:

   检查GPS是否启用：isLocationServiceEnabled

  可用该方法检查手机GPS(全球定位系统)是否打开，以此进行不同操作

  import 'package:geolocator/geolocator.dart';bool isLocationServiceEnabled  = await Geolocator.isLocationServiceEnabled();

  然后可以调用 getServiceStatusStream监听服务状态变化。这将返回一个可以监听的 Stream，以接收位置服务状态更新。

  import 'package:geolocator/geolocator.dart';StreamSubscription serviceStatusStream = Geolocator.getServiceStatusStream().listen(    (ServiceStatus status) {        print(status);    });

   检查是否允许APP获取位置权限：checkPermission

  import 'package:geolocator/geolocator.dart';LocationPermission permission = await Geolocator.checkPermission();

   APP请求获取位置权限：requestPermission

  import 'package:geolocator/geolocator.dart';LocationPermission permission = await Geolocator.requestPermission();

  checkPermission 和 requestPermission 方法返回值说明

  • denied：用户拒绝了访问设备位置的权限。您可以再次申请权限（这也是初始权限状态）。
  • deniedForever：永久拒绝访问设备位置的权限。请求权限时，权限对话框将不会显示，直到用户在应用程序设置中更新权限。
  • whileInUse：仅当应用程序正在使用时才允许访问设备位置。
  • always：即使应用程序在后台运行，也允许访问设备位置。

    打开相关设置页面：

    在某些情况下，有必要询问用户并更新其设备设置。例如，用户最初永久拒绝了APP访问设备位置的权限，或者位置服务未启用（在 Android 上，自动解析不起作用）。在这种情况下，你可以使用 openAppSettings 或 openLocationSettings 方法立即将用户重定向到设备的设置页面。 

    在安卓系统中，openAppSettings 方法将把用户重定向到应用程序特定设置，用户可以在此重新设置APP相关权限。

    openLocationSettings 方法将弹窗询问或把用户重定向到设备位置设置，用户可在此启用/禁用位置服务。

    在 iOS 系统中，我们不允许打开特定的设置页面，因此这两种方法都会将用户重定向到 "设置应用"，用户可以从该应用导航到正确的设置类别，以更新权限或启用/禁用位置服务。

    import 'package:geolocator/geolocator.dart';await Geolocator.openAppSettings();await Geolocator.openLocationSettings();

    获取当前位置：getCurrentPosition

    • desiredAccuracy：app希望接收的位置数据的精度（可选值在文章结尾有说明）；
    • timeLimit：获取当前位置所允许的最长时间。超过时间限制后，将抛出 TimeOutException 异常，并取消调用。默认情况下未配置任何限制，即永不超时。

      import 'package:geolocator/geolocator.dart';Position position = await Geolocator.getCurrentPosition(desiredAccuracy: LocationAccuracy.high);

      获取最后已知位置：getLastKnownPosition

      import 'package:geolocator/geolocator.dart';Position? position = await Geolocator.getLastKnownPosition();

      监听持续性的位置变化：getPositionStream

      • accuracy：应用程序希望接收的位置数据的精确度；
      • distanceFilter：在生成更新事件之前，设备水平移动的最小距离（以米为单位）；
      • timeLimit：位置更新之间允许的最长间隔时间。超过时限后，将抛出 TimeOutException 异常，并取消数据流。默认情况下未配置任何限制，即永不超时。

        import 'package:geolocator/geolocator.dart';final LocationSettings locationSettings = LocationSettings(  accuracy: LocationAccuracy.high,  distanceFilter: 100,);StreamSubscription positionStream = Geolocator.getPositionStream(locationSettings: locationSettings).listen(    (Position? position) {        print(position == null ? 'Unknown' : '${position.latitude.toString()}, ${position.longitude.toString()}');    });

        在某些情况下，有必要指定一些平台特定的设置。这可以通过使用特定平台的 AndroidSettings 或 AppleSettings 类来实现。使用特定平台类时，还必须导入特定平台包。示例：

        import 'package:geolocator/geolocator.dart';import 'package:geolocator_apple/geolocator_apple.dart';import 'package:geolocator_android/geolocator_android.dart';late LocationSettings locationSettings;if (defaultTargetPlatform == TargetPlatform.android) {  locationSettings = AndroidSettings(    accuracy: LocationAccuracy.high,    distanceFilter: 100,    forceLocationManager: true,    intervalDuration: const Duration(seconds: 10),    //(可选)设置前台通知配置，使应用程序在进入后台时保持活跃    foregroundNotificationConfig: const ForegroundNotificationConfig(        notificationText:        "Example app will continue to receive your location even when you aren't using it",        notificationTitle: "Running in Background",        enableWakeLock: true,    )  );} else if (defaultTargetPlatform == TargetPlatform.iOS || defaultTargetPlatform == TargetPlatform.macOS) {  locationSettings = AppleSettings(    accuracy: LocationAccuracy.high,    activityType: ActivityType.fitness,    distanceFilter: 100,    pauseLocationUpdatesAutomatically: true,    // 只有当我们的APP在后台启动时才设置为true    showBackgroundLocationIndicator: false,  );} else {    locationSettings = LocationSettings(    accuracy: LocationAccuracy.high,    distanceFilter: 100,  );}StreamSubscription positionStream = Geolocator.getPositionStream(locationSettings: locationSettings).listen(    (Position? position) {        print(position == null ? 'Unknown' : '${position.latitude.toString()}, ${position.longitude.toString()}');    });

         计算两个坐标间的距离：distanceBetween

        • startLatitude：起始位置的经度。
        • startLongitude：起始位置的纬度。
        • endLatitude：终点位置的经度。
        • endLongitude：终点位置的维度。

          import 'package:geolocator/geolocator.dart';double distanceInMeters = Geolocator.distanceBetween(52.2165157, 6.9437819, 52.3546274, 4.8285838);

           计算两个坐标间的方位：bearingBetween

          同样需要上述四个参数。

          import 'package:geolocator/geolocator.dart';double bearing = Geolocator.bearingBetween(52.2165157, 6.9437819, 52.3546274, 4.8285838);

          定位精度枚举值

          Android

          • lowest：确保不会使用额外的功率来计算位置。这意味着该请求将充当被动监听器，只接收代表其他客户端计算的 "空闲 "位置，而不会只代表该请求计算位置。（可能不会返回任何位置信息）
          • low：以可能牺牲定位精度为代价，对低功耗进行权衡。
          • medium：要求在定位精度和耗电量之间进行权衡。
          • high：要求权衡高精度定位和可能的额外耗电量。

            IOS  请求的数据越详细，对电池消耗的影响就越大。

            • lowest：精确到最近的三公里。
            • low：精确到最近的一公里。
            • medium：精度精确到一百米以内。
            • high：精确到距离所需目标十米以内。
            • best：可用的最佳精度级别。
            • bestForNavigation：使用附加传感器数据以方便导航应用程序的最高精度。

              好了，去玩吧