flutter_tencent_lbs_plugin

Description:

flutter tencent lbs plugin

flutter_tencent_lbs_plugin #

⚠️ 注意：


次插件在 iOS Simulator 中不生效。


各平台配置摘抄自官方文档，无法及时同步，仅供参考，具体配置请以官方文档为准
官方 Android 文档
官方 iOS 文档



TencentLBS 版本 #



平台
版本号
时间




Android
v7.5.4.3
2024-01-23


iOS
v4.2.0
2023-11-03



使用方式 #


创建实例
final locationPlugin = FlutterTencentLBSPlugin();
copied to clipboard


设置用户是否同意隐私协议政策，调用其他接口前必须首先调用此接口进行用户是否同意隐私政策的设置。
locationPlugin.setUserAgreePrivacy();
copied to clipboard


初始化
locationPlugin.init(key: "YOUR KEY");
copied to clipboard


单次定位 #
// 监听器（可选）
locationPlugin.addLocationListener((location) {
print(location.toJson());
});

// Future 用法
locationPlugin.getLocationOnce().then((location) {
print(location.toJson());
});
copied to clipboard
连续定位 #
// 设置监听器
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,
// ),
),
);
copied to clipboard
停止连续定位 #
locationPlugin.stop()
copied to clipboard
Android 端配置 #
配置 Key #
<application>
...
<meta-data android:name="TencentMapSDK" android:value="您申请的Key" />
</application>
copied to clipboard
权限配置 #
<!-- 通过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"/>
copied to clipboard
配置后台定位（可选） #
<application>
...
<service
android:name="com.tencent.map.geolocation.s"
android:foregroundServiceType="location" />
</application>

copied to clipboard

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

iOS 端配置 #
权限配置 #
在 info.plist 中追加 NSLocationWhenInUseUsageDescription 或NSLocationAlwaysUsageDescription 字段，以申请定位权限。
配置后台定位（可选） #
使用 Xcode 打开 ios/Runner.xcworkspace
Signing & Capabilities -> + Capability -> 搜索 “Background Modes” -> 并勾选 Location updates

避坑 #
无法获取地址描述 #
Android：需要使用 WGS84 坐标才能获取地址描述
iOS：需要使用 GCJ02 坐标才能获取地址描述

这似乎是 SDK 的默认行为

参考 #
tencent_location
flutter_tencent_location