amap_map_lite

Description:

amap map lite

amap_map #

基于高德开放平台地图SDK的flutter插件




Android
iOS




AMapSDK
9.8.3
9.7.0


Support
SDK 16+
12.0+



本插件基于 amap_flutter_map 3.0.0 进行二开的原因：

原插件21年开始已无更新，插件年久失修，依赖SDK版本老旧
原插件只实现了基础的地图展示和交互功能，无法满足常见定制化需求

Usage #
使用Flutter插件，请参考在Flutter里使用Packages, 添加amap_map的引用
flutter pub add amap_map
copied to clipboard
Prepare #

登录高德开放平台官网申请ApiKey。

Android平台申请配置key请参考Android获取key
iOS平台申请配置请参考iOS获取key



Demo #
初始化 #
在runApp启动的第一个Widget中，使用context进行组件初始化
import 'package:amap_map_lite/amap_map.dart';
import 'package:x_amap_base/x_amap_base.dart'; // AMapApiKey 和 AMapPrivacyStatement 定义在 package `x_amap_base` 中，需要一并引入

class DemoWidget extends State<AMapDemo> {

@override
Widget build(BuildContext context) {
AMapInitializer.init(context, apiKey: ConstConfig.amapApiKeys);

return Scaffold(
// ...
);
}
}
copied to clipboard
合规处理 #
高德SDK合规使用方案请参考：https://lbs.amap.com/news/sdkhgsy ，需要进行授权交互，然后通知组件。
AMapInitializer.updatePrivacyAgree(ConstConfig.amapPrivacyStatement);
copied to clipboard
使用地图 #
import 'package:amap_map_example/base_page.dart';
import 'package:flutter/material.dart';

import 'package:amap_map_lite/amap_map.dart';
import 'package:x_amap_base/x_amap_base.dart';

class ShowMapPage extends BasePage {
ShowMapPage(String title, String subTitle) : super(title, subTitle);
@override
Widget build(BuildContext context) {
return _ShowMapPageBody();
}
}

class _ShowMapPageBody extends StatefulWidget {
@override
State<StatefulWidget> createState() => _ShowMapPageState();
}

class _ShowMapPageState extends State<_ShowMapPageBody> {
static final CameraPosition _kInitialPosition = const CameraPosition(
target: LatLng(39.909187, 116.397451),
zoom: 10.0,
);
@override
Widget build(BuildContext context) {
final AMapWidget map = AMapWidget(
initialCameraPosition: _kInitialPosition,
onMapCreated: onMapCreated,
);

return ConstrainedBox(
constraints: BoxConstraints.expand(),
child: Container(
height: MediaQuery.of(context).size.height,
width: MediaQuery.of(context).size.width,
child: map,
),
);
}

AMapController _mapController;
void onMapCreated(AMapController controller) {
setState(() {
_mapController = controller;
});
}

}

copied to clipboard
更多示例 #

地图视图 #
///用于展示高德地图的Widget
class AMapWidget extends StatefulWidget {
/// 初始化时的地图中心点
final CameraPosition initialCameraPosition;

///地图类型
final MapType mapType;

///自定义地图样式
final CustomStyleOptions? customStyleOptions;

///定位小蓝点
final MyLocationStyleOptions? myLocationStyleOptions;

///缩放级别范围
final MinMaxZoomPreference? minMaxZoomPreference;

///地图显示范围
final LatLngBounds? limitBounds;

///显示路况开关
final bool trafficEnabled;

/// 地图poi是否允许点击
final bool touchPoiEnabled;

///是否显示3D建筑物
final bool buildingsEnabled;

///是否显示底图文字标注
final bool labelsEnabled;

///是否显示指南针
final bool compassEnabled;

///是否显示比例尺
final bool scaleEnabled;

///是否支持缩放手势
final bool zoomGesturesEnabled;

///是否支持滑动手势
final bool scrollGesturesEnabled;

///是否支持旋转手势
final bool rotateGesturesEnabled;

///是否支持倾斜手势
final bool tiltGesturesEnabled;

/// 地图上显示的Marker
final Set<Marker> markers;

/// 地图上显示的polyline
final Set<Polyline> polylines;

/// 地图上显示的polygon
final Set<Polygon> polygons;

/// 地图创建成功的回调, 收到此回调之后才可以操作地图
final MapCreatedCallback? onMapCreated;

/// 相机视角持续移动的回调
final ArgumentCallback<CameraPosition>? onCameraMove;

/// 相机视角移动结束的回调
final ArgumentCallback<CameraPosition>? onCameraMoveEnd;

/// 地图单击事件的回调
final ArgumentCallback<LatLng>? onTap;

/// 地图长按事件的回调
final ArgumentCallback<LatLng>? onLongPress;

/// 地图POI的点击回调，需要`touchPoiEnabled`true，才能回调
final ArgumentCallback<AMapPoi>? onPoiTouched;

///位置回调
final ArgumentCallback<AMapLocation>? onLocationChanged;

///需要应用到地图上的手势集合
final Set<Factory<OneSequenceGestureRecognizer>> gestureRecognizers;

///拓展插件，提供更多定制化功能
final List<AMapExtension> extensions;
}
copied to clipboard
地图控制器 #

class AMapController {

///改变地图视角
///
///通过[CameraUpdate]对象设置新的中心点、缩放比例、放大缩小、显示区域等内容
///
///（注意：iOS端设置显示区域时，不支持duration参数，动画时长使用iOS地图默认值350毫秒）
///
///可选属性[animated]用于控制是否执行动画移动
///
///可选属性[duration]用于控制执行动画的时长,默认250毫秒,单位:毫秒
Future<void> moveCamera(CameraUpdate cameraUpdate,
{bool animated = true, int duration = 250});

///地图截屏
Future<Uint8List?> takeSnapshot();

/// 清空缓存
Future<void> clearDisk();

/// 经纬度转屏幕坐标
Future<ScreenCoordinate> toScreenCoordinate(LatLng latLng);

/// 屏幕坐标转经纬度
Future<LatLng> fromScreenCoordinate(ScreenCoordinate screenCoordinate);
}


copied to clipboard
Issues #

[android] app 的 targetSDKVersion >= 30, 地图页返回闪退

在里的AndroidManifest.xml里的application里增加android:allowNativeHeapPointerTagging="false"
<application android:allowNativeHeapPointerTagging="false">
...
</application>
copied to clipboard
google官方说明地址：https://source.android.com/devices/tech/debug/tagged-pointers