rapidoc_maps_plugin 是一个用于在 Flutter 应用中展示和交互地图的插件。它提供了简单易用的 API，允许开发者在应用中集成地图功能，并支持各种地图操作，如缩放、平移、标记点等。

以下是如何在 Flutter 项目中使用 rapidoc_maps_plugin 的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 rapidoc_maps_plugin 的依赖。

dependencies:
  flutter:
    sdk: flutter
  rapidoc_maps_plugin: ^latest_version

然后运行 flutter pub get 来安装依赖。

2. 导入插件

在你的 Dart 文件中导入 rapidoc_maps_plugin。

import 'package:rapidoc_maps_plugin/rapidoc_maps_plugin.dart';

3. 初始化地图

在你的 Flutter 应用中初始化地图。通常，你可以在 initState 方法中进行初始化。

class MapScreen extends StatefulWidget {
  [@override](/user/override)
  _MapScreenState createState() => _MapScreenState();
}

class _MapScreenState extends State<MapScreen> {
  RapidocMapsController? _mapController;

  [@override](/user/override)
  void initState() {
    super.initState();
    _initializeMap();
  }

  void _initializeMap() async {
    _mapController = await RapidocMapsController.create();
    setState(() {});
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Rapidoc Maps Example'),
      ),
      body: _mapController != null
          ? RapidocMaps(
              controller: _mapController!,
              initialCameraPosition: CameraPosition(
                target: LatLng(37.7749, -122.4194), // 初始位置（旧金山）
                zoom: 12.0,
              ),
            )
          : Center(child: CircularProgressIndicator()),
    );
  }
}

4. 添加标记点

你可以使用 _mapController 来添加标记点到地图上。

void _addMarker() {
  if (_mapController != null) {
    _mapController!.addMarker(
      MarkerOptions(
        position: LatLng(37.7749, -122.4194),
        title: 'San Francisco',
      ),
    );
  }
}

5. 处理地图交互

你可以监听地图的交互事件，例如用户点击地图或标记点。

void _setupMapListeners() {
  if (_mapController != null) {
    _mapController!.onMapClick.listen((LatLng position) {
      print('Map clicked at: $position');
    });

    _mapController!.onMarkerClick.listen((Marker marker) {
      print('Marker clicked: ${marker.title}');
    });
  }
}

6. 其他功能

rapidoc_maps_plugin 还支持其他功能，如地图缩放、平移、获取当前地图中心点等。你可以参考插件的文档来了解更多细节。

7. 清理资源

在 dispose 方法中释放地图资源。

[@override](/user/override)
void dispose() {
  _mapController?.dispose();
  super.dispose();
}

完整示例

以下是一个完整的示例，展示了如何在 Flutter 应用中使用 rapidoc_maps_plugin。

import 'package:flutter/material.dart';
import 'package:rapidoc_maps_plugin/rapidoc_maps_plugin.dart';

class MapScreen extends StatefulWidget {
  [@override](/user/override)
  _MapScreenState createState() => _MapScreenState();
}

class _MapScreenState extends State<MapScreen> {
  RapidocMapsController? _mapController;

  [@override](/user/override)
  void initState() {
    super.initState();
    _initializeMap();
  }

  void _initializeMap() async {
    _mapController = await RapidocMapsController.create();
    _setupMapListeners();
    _addMarker();
    setState(() {});
  }

  void _addMarker() {
    if (_mapController != null) {
      _mapController!.addMarker(
        MarkerOptions(
          position: LatLng(37.7749, -122.4194),
          title: 'San Francisco',
        ),
      );
    }
  }

  void _setupMapListeners() {
    if (_mapController != null) {
      _mapController!.onMapClick.listen((LatLng position) {
        print('Map clicked at: $position');
      });

      _mapController!.onMarkerClick.listen((Marker marker) {
        print('Marker clicked: ${marker.title}');
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Rapidoc Maps Example'),
      ),
      body: _mapController != null
          ? RapidocMaps(
              controller: _mapController!,
              initialCameraPosition: CameraPosition(
                target: LatLng(37.7749, -122.4194),
                zoom: 12.0,
              ),
            )
          : Center(child: CircularProgressIndicator()),
    );
  }

  [@override](/user/override)
  void dispose() {
    _mapController?.dispose();
    super.dispose();
  }
}

void main() {
  runApp(MaterialApp(
    home: MapScreen(),
  ));
}