【亲测免费】 Flutter高德地图插件 flutter_amap 使用指南

---

安装指南

Android平台集成步骤

1. 获取API密钥： 访问高德地图API控制台，注册并创建应用后获取API密钥。

2. 配置AndroidManifest.xml： 在<application>标签内添加以下元数据：

   <meta-data
       android:name="com.amap.api.v2.apikey"
       android:value="你的API密钥" />
   

   同时，确保已经包含了必要的权限：

   <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
   <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
   <!-- 其他所需权限 -->
   

3. 添加Activity： 在<application>中添加用于承载地图的Activity：

   <activity android:name="com.jzoom.flutteramap.AMapActivity" android:theme="@style/Theme.AppCompat.Light.DarkActionBar"/>
   

iOS平台集成指南

1. 获取API密钥： 同样通过访问高德地图API控制台获取iOS应用的API密钥。

2. Dart代码设置密钥： 在应用程序启动时设置API密钥，如main.dart中：

   import 'package:flutter_amap/flutter_amap.dart';
   
   void main() {
     FlutterAmap.setApiKey("你的iOS API密钥");
     runApp(MyApp());
   }
   

3. 配置Info.plist： 添加定位使用描述：

   <key>NSLocationWhenInUseUsageDescription</key>
   <string>应用需要您的位置信息以提供服务。</string>
   

项目使用说明

1. 依赖添加： 在项目的pubspec.yaml文件中，加入flutter_amap的依赖：

   dependencies:
     flutter_amap: "^0.0.1"
   

   运行flutter pub get来下载依赖。

2. 导入与基础使用： 在需要使用地图功能的dart文件顶部引入库：

   import 'package:flutter_amap/flutter_amap.dart';
   

   示例用法如下：

   FlutterAmap amap = new FlutterAmap();
   
   void displayMap() {
     amap.show(
         mapview: new AMapView(
             centerCoordinate: new LatLng(39.9242, 116.3979), // 中心点坐标
             zoomLevel: 13.0, // 缩放等级
             mapType: MapType.night, // 夜间模式
             showsUserLocation: true), // 显示用户位置
         title: new TitleOptions(title: "北京地图")); // 标题选项
     // 监听位置更新
     amap.onLocationUpdated.listen((Location location) {
       print("位置更新: $location");
     });
   }
   

API使用文档

当前版本提供了基本地图操作，如展示地图、设定初始位置、地图类型切换以及接收位置更新事件。更高级的功能如自定义标记、搜索API等尚待实现。

---

此文档为基于flutter_amap插件的基础使用说明，涵盖了从安装到使用的全过程。随着插件的持续更新，更多特性将会被加入，开发者应参照最新的文档进行应用开发。