amap_location_flutter - Dart API docs

前述

高德定位Flutter插件
高德开放平台官网分别申请Android端和iOS端的key
如需了解高德定位SDK的相关功能，请参阅Android定位SDK开发指南和iOS定位SDK开发指南
高德定位Flutter插件内部没有集成动态申请权限插件，您可根据自身需要添加相应的权限申请插件。可以参考permisson_handler插件
Android 端注意：本插件把 com.amap.api:location 声明为 compileOnly（不会自动打包进您的 App），目的是避免和您 App 里可能已经引入的其他高德 SDK（如 amap-map 等）产生重复类冲突。因此接入方需要自行在 App 的 android/app/build.gradle（或 build.gradle.kts）里添加该依赖，例如：

dependencies {
    implementation 'com.amap.api:location:11.2.100'
}

版本号可以根据需要选择更新的版本，但需与其他高德 SDK 的版本保持兼容。

使用高德定位Flutter插件

集成高德定位Flutter插件

集成方式：

方式一 pub.flutter-io.cn 引用（推荐）

在 pubspec.yaml 的 dependencies 里添加如下代码

amap_location_flutter: ^1.0.0

执行 flutter pub get 等待插件下载完成

方式二 github方引用

在pubspect.yaml的dependencies里添加如下代码

amap_location_flutter:
  git:
    url: https://github.com/zp0708/amap-location-flutter.git

执行flutter packages get等待插件下载完成

方式三下载到本地引用

下载高德定位Flutter插件源码
在本地工程目录下创建plugins目录，将下载的目录复制到plugins目录下
在pubspect.yaml的dependencies里添加如下代码

amap_location_flutter:
  path: plugins/amap-location-flutter

执行flutter packages get等待插件现在完成

常见问题：

1、在iOS设备上运行或者运行iOS工程遇到： Invalid Podfile file: cannot load such file - /flutter/packages/flutter_tools/bin/podhelper

$ rm ios/Podfile
$ flutter build ios

在需要的定位功能的页面中引入定位Flutter插件的dart类

import 'package:amap_location_flutter/amap_location_flutter.dart';
import 'package:amap_location_flutter/amap_location_option.dart';

接口说明

设置APIKey

///设置Android和iOS的apikey，建议在开始定位之前设置
///[androidKey] Android平台的key
///[iosKey] ios平台的key
static void setApiKey(String androidKey, String iosKey)

申请定位权限

/// 申请定位权限
/// 授予定位权限返回true， 否则返回false
Future<bool> requestLocationPermission()

设置定位参数

 /// 设置定位参数
 void setLocationOption(AMapLocationOption locationOption)

将您设置的参数传递到原生端对外接口，目前支持以下定位参数

 /// 是否需要地址信息，默认true
  bool needAddress = true;

  ///逆地理信息语言类型
  ///默认[GeoLanguage.DEFAULT] 自动适配
  ///可选值：
  ///[GeoLanguage.DEFAULT] 自动适配
  ///[GeoLanguage.EN] 英文
  ///[GeoLanguage.ZH] 中文
  GeoLanguage geoLanguage;

  ///是否单次定位
  ///默认值：false
  bool onceLocation = false;

  ///Android端定位模式, 只在Android系统上有效>
  ///默认值：[AMapLocationMode.Hight_Accuracy]
  ///可选值：
  ///[AMapLocationMode.Battery_Saving]
  ///[AMapLocationMode.Device_Sensors]
  ///[AMapLocationMode.Hight_Accuracy]
  AMapLocationMode locationMode;

  ///Android端定位间隔
  ///单位：毫秒
  ///默认：2000毫秒
  int locationInterval = 2000;

  ///iOS端是否允许系统暂停定位
  ///默认：false
  bool pausesLocationUpdatesAutomatically = false;

  /// iOS端期望的定位精度， 只在iOS端有效
  /// 默认值：最高精度
  /// 可选值：
  /// [DesiredAccuracy.Best] 最高精度
  /// [DesiredAccuracy.BestForNavigation] 适用于导航场景的高精度
  /// [DesiredAccuracy.NearestTenMeters] 10米
  /// [DesiredAccuracy.Kilometer] 1000米
  /// [DesiredAccuracy.ThreeKilometers] 3000米<
  DesiredAccuracy desiredAccuracy = DesiredAccuracy.Best;

  /// iOS端定位最小更新距离
  /// 单位：米
  /// 默认值：-1，不做限制
  double distanceFilter = -1;

开始定位

void startLocation()

停止定位

void stopLocation()

销毁定位

高德定位Flutter插件，支持多实例，请在weidet执行dispose()时调用当前定位插件的销毁方法

void destroy()

定位结果获取

原生端以键值对map的形式回传定位结果到Flutter端, 通过onLoationChanged返回定位结果

Stream<Map<String, Object?>> onLocationChanged(）

注册定位结果监听

_locationPlugin
        .onLocationChanged()
        .listen((Map<String, Object?> result) {
          ///result即为定位结果
        }

Getting Started

For help getting started with Flutter, view our online documentation.

For help on editing plugin code, view the documentation.

前述