Flutter地图展示插件x_map的使用

Flutter地图展示插件x_map的使用

基于高德开放平台地图SDK的二次开发Flutter插件,扩展了一些原本插件不支持的Android部分功能。

使用说明

使用Flutter插件,添加x_map的引用。

准备工作

  1. 登录高德开放平台官网申请ApiKey。Android平台申请配置key请参考Android获取key,iOS平台申请配置请参考iOS获取key
  2. 引入高德地图SDK,Android平台请参考Android Studio配置工程,iOS平台请参考ios安装地图SDK
  3. 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

1 回复

更多关于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. 添加标记和绘制路线

你可以使用 MarkerPolyline 来在地图上添加标记和绘制路线。

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. 处理用户交互

你可以通过 onTaponLongPress 等回调来处理用户与地图的交互。

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');
  },
);
回到顶部