Flutter地图展示插件x_map的使用
Flutter地图展示插件x_map的使用
基于高德开放平台地图SDK的二次开发Flutter插件,扩展了一些原本插件不支持的Android部分功能。
使用说明
使用Flutter插件,添加x_map的引用。
准备工作
- 登录高德开放平台官网申请ApiKey。Android平台申请配置key请参考Android获取key,iOS平台申请配置请参考iOS获取key。
- 引入高德地图SDK,Android平台请参考Android Studio配置工程,iOS平台请参考ios安装地图SDK。
- iOS端插件使用特殊配置:Flutter 1.22.0 之前(之后的版本可以不添加该配置),iOS端的UiKitView还只是preview状态,默认是不支持的,需要手动打开开关,在iOS工程的info.plist添加如下配置:
<key>io.flutter.embedded_views_preview</key>
<string>YES</string>
使用示例
以下是一个完整的示例代码,展示了如何使用x_map插件来展示地图。
import 'package:x_map_example/base_page.dart';
import 'package:flutter/material.dart';
import 'package:x_map/amap_flutter_map.dart';
import 'package:amap_flutter_base/amap_flutter_base.dart';
class ShowMapPage extends BasePage {
ShowMapPage(String title, String subTitle) : super(title, subTitle);
[@override](/user/override)
Widget build(BuildContext context) {
return _ShowMapPageBody();
}
}
class _ShowMapPageBody extends StatefulWidget {
[@override](/user/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,
);
// 审图号列表
List<Widget> _approvalNumberWidget = List<Widget>();
[@override](/user/override)
Widget build(BuildContext context) {
final AMapWidget map = AMapWidget(
initialCameraPosition: _kInitialPosition,
onMapCreated: onMapCreated,
);
return ConstrainedBox(
constraints: BoxConstraints.expand(),
child: Stack(
alignment: Alignment.center,
children: [
Container(
height: MediaQuery.of(context).size.height,
width: MediaQuery.of(context).size.width,
child: map,
),
Positioned(
right: 10,
bottom: 15,
child: Container(
alignment: Alignment.centerLeft,
child: Column(
mainAxisAlignment: MainAxisAlignment.start,
children: _approvalNumberWidget),
))
],
),
);
}
AMapController _mapController;
void onMapCreated(AMapController controller) {
setState(() {
_mapController = controller;
getApprovalNumber();
});
}
/// 获取审图号
void getApprovalNumber() async {
// 普通地图审图号
String mapContentApprovalNumber =
await _mapController?.getMapContentApprovalNumber();
// 卫星地图审图号
String satelliteImageApprovalNumber =
await _mapController?.getSatelliteImageApprovalNumber();
setState(() {
if (null != mapContentApprovalNumber) {
_approvalNumberWidget.add(Text(mapContentApprovalNumber));
}
if (null != satelliteImageApprovalNumber) {
_approvalNumberWidget.add(Text(satelliteImageApprovalNumber));
}
});
print('地图审图号(普通地图): $mapContentApprovalNumber');
print('地图审图号(卫星地图): $satelliteImageApprovalNumber');
}
}
更多关于Flutter地图展示插件x_map的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html
更多关于Flutter地图展示插件x_map的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html
x_map
是一个用于在 Flutter 应用中展示地图的插件。它基于高德地图(AMap)的 SDK,提供了丰富的功能来展示地图、标记位置、绘制路线等。以下是如何在 Flutter 项目中使用 x_map
插件的基本步骤。
1. 添加依赖
首先,在你的 pubspec.yaml
文件中添加 x_map
依赖:
dependencies:
flutter:
sdk: flutter
x_map: ^0.0.1 # 请查看最新版本
然后运行 flutter pub get
来安装依赖。
2. 配置高德地图 SDK
在使用 x_map
之前,你需要在高德开放平台注册并创建一个应用,获取到 API Key
。
Android 配置
在 android/app/src/main/AndroidManifest.xml
中添加以下代码:
<meta-data
android:name="com.amap.api.v2.apikey"
android:value="你的高德地图API Key" />
iOS 配置
在 ios/Runner/Info.plist
中添加以下代码:
<key>NSLocationWhenInUseUsageDescription</key>
<string>我们需要使用您的位置来展示地图</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>我们需要使用您的位置来展示地图</string>
<key>NSCameraUsageDescription</key>
<string>我们需要使用摄像头来展示地图</string>
<key>NSMicrophoneUsageDescription</key>
<string>我们需要使用麦克风来展示地图</string>
<key>AMapApiKey</key>
<string>你的高德地图API Key</string>
3. 使用 x_map
展示地图
在你的 Flutter 代码中,你可以使用 XMap
组件来展示地图:
import 'package:flutter/material.dart';
import 'package:x_map/x_map.dart';
void main() {
runApp(MyApp());
}
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
appBar: AppBar(
title: Text('XMap Example'),
),
body: Center(
child: XMap(
initialCameraPosition: CameraPosition(
target: LatLng(39.90923, 116.397428), // 初始位置
zoom: 15.0, // 缩放级别
),
onMapCreated: (controller) {
// 地图创建完成后的回调
},
),
),
),
);
}
}
4. 添加标记和绘制路线
你可以使用 Marker
和 Polyline
来在地图上添加标记和绘制路线。
XMap(
initialCameraPosition: CameraPosition(
target: LatLng(39.90923, 116.397428),
zoom: 15.0,
),
markers: {
Marker(
markerId: MarkerId('marker1'),
position: LatLng(39.90923, 116.397428),
infoWindow: InfoWindow(title: 'Marker 1'),
),
},
polylines: {
Polyline(
polylineId: PolylineId('polyline1'),
points: [
LatLng(39.90923, 116.397428),
LatLng(39.91923, 116.407428),
],
color: Colors.blue,
width: 5,
),
},
onMapCreated: (controller) {
// 地图创建完成后的回调
},
);
5. 处理用户交互
你可以通过 onTap
、onLongPress
等回调来处理用户与地图的交互。
XMap(
initialCameraPosition: CameraPosition(
target: LatLng(39.90923, 116.397428),
zoom: 15.0,
),
onTap: (LatLng position) {
print('Tapped at $position');
},
onLongPress: (LatLng position) {
print('Long pressed at $position');
},
);