Flutter高德地图插件使用指南

本插件提供了在Flutter应用中集成高德地图的功能，支持地图显示、定位及导航等核心功能。以下是详细的使用说明。

效果展示

插件集成了地图显示、用户定位和导航功能，具体效果如下图所示：

地图展示

用户定位

导航功能

安装步骤

1. 添加依赖

在项目的 pubspec.yaml 文件中添加插件依赖：

dependencies:
  ai_amap: ^version

或者直接从GitHub仓库添加依赖：

dependencies:
  ai_amap:
    git:
      url: https://github.com/pdliuw/ai_amap.git

2. 安装依赖

运行以下命令来安装依赖项：

$ flutter pub get

也可以通过IDE中的图形界面完成上述步骤。

3. 导入插件

在Dart文件中导入插件：

import 'package:ai_amap/ai_amap.dart';

使用方法

使用地图功能前，需要确保已申请必要的权限，建议使用 permission_handler 插件来动态请求权限。

权限配置

Android

在 AndroidManifest.xml 文件中添加以下权限：

iOS

在 Info.plist 文件中添加以下权限：

NSLocationAlwaysAndWhenInUseUsageDescription
始终允许定位(提高后台定位准确率)
NSLocationAlwaysUsageDescription
使用时始终允许定位
NSLocationWhenInUseUsageDescription
使用时允许定位

为了提高iOS设备上的定位成功率，建议开启 Background Modes 并勾选 Location updates。

PlatformView 配置

对于iOS平台，需要在 AppDelegate.m 文件中添加以下配置：

@import Flutter;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  [ GENERATED_PLUGIN_REGISTRANT() registerWithRegistry:self];
  FlutterViewController *cOntroller= (FlutterViewController *)self.window.rootViewController;
  [GeneratedPluginRegistrant registerWithRegistry:controller];
  return [super application:application didFinishLaunchingWithOptions:launchOptions];
}

@end

使用地图功能

在需要使用地图的页面中，首先创建地图控件：

// 创建地图控件
final _aMapWidget = AiAMapLocationPlatformWidget(
  platformWidgetController: _locationController,
);

然后创建地图控制器，并设置回调函数：

final _locatiOnController= AiAMapLocationPlatformWidgetController(
  locationResultCallback: (AiAMapLocationResult locationResult, bool isSuccess) {
    setState(() {
      _currentState = "定位: $isSuccess";
    });

    if (locationResult.haveAddress()) {
      _locationController.stopLocation();
      setState(() {
        if (widget._locationResultTest != null) {
          widget._locationResultTest(locationResult, isSuccess);
        }
        _locatiOnAddress= locationResult.address;
      });
    }
  },
  platformViewCreatedCallback: (int id) {
    setState(() {
      // 设置API Key
      AiAMapLocationPlatformWidgetController.setApiKey(apiKey: "$_yourPrimaryKey");
      // 初始化定位服务
      _locationController.recreateLocationService();
      _locationController.startLocation();
      _currentState = "开始定位";
    });
  },
);

项目示例

为了帮助Flutter开发者更好地理解和使用本插件，我们提供了一个示例项目 flutter_app_sample。该项目包含了多种Flutter组件和技术的示例，旨在帮助开发者快速上手并避免常见的技术陷阱。

主要特点包括：

• 专注于技术示例，涵盖多种技术点。


• 为Flutter开发者量身定制的API演示应用。


• 包含各种Flutter组件、开发包、插件以及与原生平台交互的示例。

如果您觉得这个项目对您有帮助，欢迎给它一个Star，这将激励我们继续推出更多有用的技术示例。