Flutter谷歌地图导航功能插件google_maps_navigation的使用

描述

此存储库包含一个Flutter插件，该插件为面向Android和iOS的应用程序提供了一个Google导航小部件。

要求

Android

iOS

• 一个Flutter项目
• 一个启用出行解决方案的Google云项目，例如按需乘车和送货或最后一英里车队解决方案。这需要您按照出行服务文档中的描述联系销售。
• 在该Google云项目中，根据您的Flutter应用程序的目标，还需要启用以下四个产品：
  • Android版地图SDK
  • Android版导航SDK
  • iOS版地图SDK
  • iOS版导航SDK
• 从上述项目获取的API密钥
• 如果目标是Android，则需要安装并启用Google Play服务
• 将 attribution和许可文本添加到您的应用中

安装

1. 要将Google导航插件添加到项目中，请使用以下命令：

pub add google_navigation_flutter

1. 设置目标平台的最低版本。

Android

在android/app/build.gradle文件中设置minSdkVersion：

android {
    defaultConfig {
        minSdkVersion 23
    }
}

iOS

1. 打开ios/Podfile配置文件。
2. 在Podfile的开头添加以下行：

platform :ios, '14.0'

1. 使用这些说明向Flutter项目添加API密钥。这些步骤适用于Android（build.gradle）和iOS（AppDelegate.swift）文件。

要安全地加载您的API密钥，可以使用Secrets Gradle插件。此插件有助于管理API密钥而不将其暴露在应用源代码中。

更多详细信息，请参阅Google导航SDK文档。

使用

现在可以在小部件树中添加一个GoogleMapsNavigationView小部件。

可以通过通过onViewCreated回调传递的GoogleNavigationViewController来控制视图。

GoogleMapsNavigationView小部件应在一个具有限定大小的小部件内使用。如果在其无边界小部件中使用，将导致应用程序抛出Flutter异常。

添加导航视图

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

class NavigationSample extends StatefulWidget {
  const NavigationSample({Key? key}) : super(key: key);

  [@override](/user/override)
  State<NavigationSample> createState() => _NavigationSampleState();
}

class _NavigationSampleState extends State<NavigationSample> {
  GoogleNavigationViewController? _navigationViewController;
  bool _navigationSessionInitialized = false;

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

  Future<void> _initializeNavigationSession() async {
    if (!await GoogleMapsNavigator.areTermsAccepted()) {
      await GoogleMapsNavigationManager.showTermsAndConditionsDialog(
        'Example title',
        'Example company',
      );
    }
    // 注意：确保用户已授予位置权限后再开始导航会话。
    await GoogleMapsNavigator.initializeNavigationSession();
    setState(() {
      _navigationSessionInitialized = true;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Google Maps Navigation Sample')),
      body: _navigationSessionInitialized
          ? GoogleMapsNavigationView(
              onViewCreated: _onViewCreated,
              initialNavigationUIEnabledPreference: NavigationUIEnabledPreference.disabled,
              // 其他视图初始化设置
            )
          : const Center(child: CircularProgressIndicator()),
    );
  }

  void _onViewCreated(GoogleNavigationViewController controller) {
    _navigationViewController = controller;
    controller.setMyLocationEnabled(true);
    // 可以在此处添加其他设置。
  }

  [@override](/user/override)
  void dispose() {
    if (_navigationSessionInitialized) {
      GoogleMapsNavigator.cleanup();
    }
    super.dispose();
  }
}

查看示例目录中的完整导航示例应用。

请求和处理权限

Google导航SDK Flutter插件提供了需要特定移动操作系统权限的功能。这些包括但不限于位置服务、后台执行和接收后台位置更新。

您可以查看示例应用的main.dart文件中的权限处理示例：

PermissionStatus _locationPermissionStatus = PermissionStatus.denied;

// ...

/// 请求访问设备位置的权限。
///
/// Android: 精确和粗略位置
/// iOS: CoreLocation（始终和当应用使用时）
Future<void> _requestLocationPermission() async {
  final PermissionStatus status = await Permission.location.request();

  setState(() {
    _locationPermissionStatus = status;
  });
}

// ...

[@override](/user/override)
Widget build(BuildContext context) {
  _requestLocationPermission();
  ...
}