概述

腾讯定位服务 Flutter 插件（tencent_location_flutter_plugin）是腾讯位置服务面向 Flutter 开发者推出的官方插件，为同一份 Dart 代码提供跨平台的定位、地理围栏、设备朝向、坐标工具等能力。

本文档介绍插件提供的核心能力、平台支持矩阵以及版本范围。

核心能力

表中 ✅ 表示该平台原生支持，⚠️ 表示部分支持（在对应功能文档中详述），— 表示原生未提供对应能力。各 API 在单端不支持时的具体行为（抛错或订阅静默），见对应章节。

平台支持

HarmonyOS 端需要使用 OpenHarmony 社区维护的鸿蒙分支 Flutter（3.22.0-ohos）编译，具体接入步骤见 集成 Flutter 插件。

各 API 的更细粒度的平台差异（例如「连续定位三端通用，前台服务仅 Android 可用」），请见对应章节。

文档结构

• 入门指南

  • 概述：本页

  • 兼容性说明：Flutter / Dart / Android / iOS / HarmonyOS 版本要求

  • 集成 Flutter 插件：依赖、ApiKey、权限配置

  • 隐私合规接口：隐私政策同意接口

  • 快速开始：最小可运行示例

• 功能介绍

  • 单次定位

  • 连续定位

  • 地理围栏

  • 设备朝向

  • 工具类

• 参考

  • 错误码

  • 参考手册

• 下载

一行示例

import 'package:tencent_location_flutter_plugin/tencent_location_flutter_plugin.dart';

Future<void> main() async {
  await TencentLocationSDK.setPrivacyPolicyAgreement(true);
  await TencentLocationSDK.init(
    androidApiKey: 'YOUR_ANDROID_API_KEY',
    iosApiKey: 'YOUR_IOS_API_KEY',
    harmonyApiKey: 'YOUR_HARMONY_API_KEY',
  );

  final manager = TencentLocationManager();
  final location = await manager.startSingleLocation(
    TencentLocationRequest.create()
      ..setRequestLevel(RequestLevel.adminArea),
  );
  print('当前位置：${location.latitude}, ${location.longitude}');
  await manager.dispose();
}

完整步骤见 快速开始。