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=true
android.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" 文件，将以下两行中的一行添加为<manifest> 标签的直接子代（当这两种权限都配置时，geolocator将使用 ACCESS_FINE_LOCATION）：

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

如果你目标用户用的是Android10或者以上的系统，就需要再添加ACCESS_BACKGROUND_LOCATION这条权限
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

IOS系统

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

<key>NSLocationWhenInUseUsageDescription</key>
<string>This app needs access to location when open.</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>This app needs access to location when in the background.</string>

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

使用 requestTemporaryFullAccuracy({purposeKey: "YourPurposeKey"}) 方法时，应在 Info.plist 文件中添加一个字典。第二个键（本例中称为 YourPurposeKey）应与 requestTemporaryFullAccuracy() 方法中传递的 purposeKey 相匹配
<key>NSLocationTemporaryUsageDescriptionDictionary</key>
<dict>
  <key>YourPurposeKey</key>
  <string>The example App requires temporary access to the device&apos;s precise location.</string>
</dict>

简单使用举例：

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

/// 位置服务
  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<ServiceStatus>，以接收位置服务状态更新。

import 'package:geolocator/geolocator.dart';

StreamSubscription<ServiceStatus> 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<Position> 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<Position> 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：使用附加传感器数据以方便导航应用程序的最高精度。