Flutter腾讯位置服务插件flutter_tencent_lbs_plugin的使用

Flutter腾讯位置服务插件flutter_tencent_lbs_plugin的使用

注意事项：

• 该插件在 iOS 模拟器中不生效。
• 各平台配置摘抄自官方文档，无法及时同步，仅供参考。具体配置请以官方文档为准。
  • 官方 Android 文档
  • 官方 iOS 文档

TencentLBS 版本：

使用方式：

1. 创建实例

   final locationPlugin = FlutterTencentLBSPlugin();
   

2. 设置用户是否同意隐私协议政策
   调用其他接口前必须首先调用此接口进行用户是否同意隐私政策的设置。

   locationPlugin.setUserAgreePrivacy();
   

3. 初始化

   locationPlugin.init(key: "YOUR KEY");
   

单次定位

// 监听器（可选）
locationPlugin.addLocationListener((location) {
  print(location.toJson());
});

// Future 用法
locationPlugin.getLocationOnce().then((location) {
  print(location.toJson());
});

连续定位

// 设置监听器
locationPlugin.addLocationListener((location) {
  print(location.toJson());
});

// 开启连续定位
locationPlugin.getLocation(
  interval: 1000 * 15, // 获取定位的间隔时间
  backgroundLocation: true, // 是否需要设置后台定位，设置为 true 时，请确保 Android、iOS 平台进行相应配置，否则可能抛出异常
  // Android 端后台定位需要配置常驻通知
  androidNotificationOptions: AndroidNotificationOptions(
    id: 100,
    channelId: "100",
    channelName: "定位常驻通知",
    notificationTitle: "定位常驻通知标题文字",
    notificationText: "定位常驻通知内容文字",
    // iconData: const NotificationIconData(
    //   resType: ResourceType.mipmap,
    //   resPrefix: ResourcePrefix.ic,
    //   name: 'launcher',
    //   backgroundColor: Colors.red,
    // ),
  ),
);

停止连续定位

locationPlugin.stop();

Android 端配置

1. 配置 Key

   <application>
       ...
       <meta-data android:name="TencentMapSDK" android:value="您申请的Key" />
   </application>
   

2. 权限配置

   <!-- 通过GPS得到精确位置 -->
   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
   <!-- 通过网络得到粗略位置 -->
   <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
   <!-- 访问网络，某些位置信息需要从网络服务器获取 -->
   <uses-permission android:name="android.permission.INTERNET"/>
   <!-- 访问WiFi状态，需要WiFi信息用于网络定位 -->
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
   <!-- 修改WiFi状态，发起WiFi扫描, 需要WiFi信息用于网络定位 -->
   <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
   <!-- 访问网络状态, 检测网络的可用性，需要网络运营商相关信息用于网络定位 -->
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
   <!-- 访问网络的变化, 需要某些信息用于网络定位 -->
   <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"/>
   <!-- 蓝牙扫描权限 -->
   <uses-permission android:name="android.permission.BLUETOOTH"/>
   <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
   <!-- 前台service权限 -->
   <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
   <!-- 后台定位权限 -->
   <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>
   <!-- A-GPS辅助定位权限，方便GPS快速准确定位 -->
   <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS"/>
   

3. 配置后台定位（可选）

   <application>
       ...
       <service
           android:name="com.tencent.map.geolocation.s"
           android:foregroundServiceType="location" />
   </application>
   

   自行决定是否需要忽略电池优化，此插件不包含该逻辑。

iOS 端配置

1. 权限配置 在 info.plist 中追加 NSLocationWhenInUseUsageDescription 或 NSLocationAlwaysUsageDescription 字段，以申请定位权限。

2. 配置后台定位（可选） 使用 Xcode 打开 ios/Runner.xcworkspace

   Signing & Capabilities -> + Capability -> 搜索 “Background Modes” -> 并勾选 `Location updates`
   

   

避坑

1. 无法获取地址描述

   • Android：需要使用 WGS84 坐标才能获取地址描述。
   • iOS：需要使用 GCJ02 坐标才能获取地址描述。

   这似乎是 SDK 的默认行为。

参考

• tencent_location
• flutter_tencent_location

完整示例Demo

import 'package:flutter/material.dart';

import 'package:flutter_local_notifications/flutter_local_notifications.dart';
import 'package:flutter_tencent_lbs_plugin/flutter_tencent_lbs_plugin.dart';
import 'package:permission_handler/permission_handler.dart';

final instance = FlutterLocalNotificationsPlugin();

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: Scaffold(body: MainApp()),
    );
  }
}

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

  [@override](/user/override)
  State<MainApp> createState() => _MainAppState();
}

class _MainAppState extends State<MainApp> {
  final locationPlugin = FlutterTencentLBSPlugin();

  [@override](/user/override)
  void initState() {
    locationPlugin.setUserAgreePrivacy();
    locationPlugin.init(
      key: "YOUR KEY",
    );
    locationPlugin.addLocationListener((location) {
      print("[[ listener ]]: ${location.toJson()}");
    });
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return SafeArea(
      child: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          crossAxisAlignment: CrossAxisAlignment.center,
          children: [
            FilledButton(
              onPressed: () {
                instance
                    .resolvePlatformSpecificImplementation<AndroidFlutterLocalNotificationsPlugin>()
                    ?.requestNotificationsPermission();
              },
              child: const Text("请求 Android 通知权限"),
            ),
            FilledButton(
              onPressed: () {
                Permission.location.request();
              },
              child: const Text("请求定位权限"),
            ),
            FilledButton(
              onPressed: () {
                locationPlugin.getLocationOnce().then(
                  (value) {
                    print("[[ getLocationOnce ]]: ${value?.toJson()}");
                    showDialog(
                      context: context,
                      builder: (context) {
                        return AlertDialog(
                          content: Text(
                            "${value?.address ?? "N/A"}${value?.name ?? "N/A"}",
                          ),
                        );
                      },
                    );
                  },
                  onError: (err) {
                    print("[[ getLocationOnce ERROR ]]: $err");
                  },
                );
              },
              child: const Text("获取一次定位"),
            ),
            FilledButton(
              onPressed: () {
                locationPlugin.getLocation(
                  interval: 1000 * 15,
                  backgroundLocation: true,
                  androidNotificationOptions: AndroidNotificationOptions(
                    id: 100,
                    channelId: "100",
                    channelName: "定位常驻通知",
                    notificationTitle: "定位常驻通知标题文字",
                    notificationText: "定位常驻通知内容文字",
                    // iconData: const NotificationIconData(
                    //   resType: ResourceType.mipmap,
                    //   resPrefix: ResourcePrefix.ic,
                    //   name: 'launcher',
                    //   backgroundColor: Colors.red,
                    // ),
                  ),
                );
              },
              child: const Text("连续定位"),
            ),
            FilledButton(
              onPressed: locationPlugin.stop,
              child: const Text("停止连续定位"),
            ),
          ],
        ),
      ),
    );
  }
}