Flutter 地图应用插件 map_apptimus 的使用

Map Apptimus

Map Apptimus 是一个 Flutter 包，用于在您的 Flutter 应用程序中集成地图和搜索功能。

开始使用

前提条件

在使用此包之前，您需要从 Google Cloud 控制台获取一个 Google API 密钥以进行地图集成。

安装

将以下依赖项添加到您的 pubspec.yaml 文件中：

dependencies:
  map_apptimus: ^0.0.1

运行 flutter pub get 来安装该包。

Android 配置

在您的 android/app/build.gradle 文件中，确保有以下配置：

android {
    ...
    compileSdkVersion 33
    defaultConfig {
        ...
        minSdkVersion 21
        ...
    }
    ...
}

添加权限

在您的 AndroidManifest.xml 文件中，添加以下权限：

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

添加 Google API 密钥

同样，在 AndroidManifest.xml 文件中添加您的 Google API 密钥：

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="Your_api_key" />

使用

简单的地图集成应用

首先，创建一个简单的地图集成应用。在 main.dart 文件中，使用以下代码：

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

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '地图演示',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: MapScreen(
        searchfunction: true,       // 启用搜索功能
        straightDistance: true,     // 启用直线距离计算
        routeDistance: true,        // 启用路线距离计算
        showRoute: true,            // 显示路线
        userkey: 'your_api_key',    // 替换为您的 Google API 密钥
      ),
    );
  }
}

简单的 Google 搜索功能

接下来，实现一个简单的 Google 搜索功能。在 main.dart 文件中，使用以下代码：

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

class SearchService {
  void searchbar(TextEditingController searchController, Function onItemClicked, {required String userkey}) {
    // 实现搜索逻辑
  }
}

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '地图演示',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  const HomeScreen({super.key});

  [@override](/user/override)
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  final TextEditingController searchController = TextEditingController();
  final SearchService searchservice = SearchService();

  void onItemClicked(String item) {
    // 处理搜索结果点击事件
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('搜索功能'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(8.0),
        child: Column(
          children: [
            TextField(
              controller: searchController,
              decoration: InputDecoration(hintText: '搜索地点'),
            ),
            ElevatedButton(
              onPressed: () {
                searchservice.searchbar(searchController, onItemClicked, userkey: 'your_api_key');
              },
              child: Text('搜索'),
            ),
          ],
        ),
      ),
    );
  }
}