6月产品上新Flutter SDK 正式上线一份Dart 代码双端跑通定位与地图位置服务跨端开发者久等啦过去开发者们在 Flutter 里做定位和地图要么自己用 MethodChannel 手写桥接容易踩平台差异的坑要么依赖第三方方案能力完整度和长期维护都难有保障。腾讯位置服务正式发布官方 Flutter 插件定位 SDK 与地图 SDK 现已全面完成 Flutter 适配。开发者只需编写一套 Dart 代码即可在 Android 与 iOS 双端直接调用原生级能力无需额外适配。这不仅大幅降低了 Flutter 开发者的接入门槛更让开发者能以最小成本获得与原生 SDK 对齐的定位和地图功能。且该插件由腾讯位置服务官方团队持续维护确保长期稳定更新与技术支持为您的跨端应用提供可靠的位置服务底座。 PART 01 · 腾讯位置服务定位 SDK跨端定位能力一站式打包定位插件tencent_location_flutter_plugin为同一份 Dart 代码提供跨平台的定位、地理围栏、设备朝向、坐标工具等完整能力。 核心能力一览能力说明AndroidiOS连续定位可订阅的位置流支持设置回调间隔、坐标系、返回等级、逆地址解析等参数✅✅单次定位一次性获取当前定位结果可配置超时时长✅✅地理围栏圆形 / 多边形 / 行政区划三种形态支持进入 / 离开 / 停留事件回调✅✅设备朝向订阅式获取真北方向、磁北方向等朝向信息-✅设备状态随连续定位一并产生 GPS / Wi-Fi / 蜂窝 / 定位总开关等状态变化事件✅-前台定位服务让定位在应用进入后台时也能继续运行✅-工具方法坐标系互转、两点距离计算、点是否落在指定圆内等通用工具✅✅多实例同一应用内可创建多个定位 / 围栏管理器事件流互不干扰✅✅ 一段代码看懂接入importpackage:tencent_location_flutter_plugin/tencent_location_flutter_plugin.dart;Futurevoidmain()async{// ① 隐私合规同意awaitTencentLocationSDK.setPrivacyPolicyAgreement(true);// ② 初始化双端各自的 KeyawaitTencentLocationSDK.init(androidApiKey:YOUR_ANDROID_API_KEY,iosApiKey:YOUR_IOS_API_KEY,);// ③ 发起一次单次定位finalmanagerTencentLocationManager();finallocawaitmanager.startSingleLocation(TencentLocationRequest.create()..setRequestLevel(RequestLevel.adminArea),);print(当前位置${loc.latitude},${loc.longitude});}️ PART 02 · 腾讯位置服务地图 SDK核心功能对齐原生地图插件flutter_tencent_map首期交付的地图核心功能覆盖地图展示、交互、覆盖物三大板块 核心功能一览核心功能说明️ 地图基础创建和显示地图、地图类型切换标准 / 卫星、自定义地图样式个性化地图、显示定位、实时路况、3D 建筑物、底图标注控制、隐私合规、Logo 位置控制 地图交互手势控制缩放 / 滑动 / 旋转 / 倾斜点击事件单击 / 长按 / POI 点击、UI 控件指南针 / 比例尺、缩放范围限制、显示区域限制、相机视角控制含动画、坐标转换屏幕 ↔ 经纬度、地图截图 覆盖物点标记 Marker / InfoWindow、折线 Polyline折线、虚线、纹理线等、多边形 Polygon简单多边形带洞多边形纹理边框等✨ PART 03 · 腾讯位置服务Flutter插件亮点腾讯位置服务Flutter插件不是简单地把原生 API「翻译」一遍而是围绕 Flutter 的声明式范式做了系统性的工程设计。亮点 1 · 接入快双端零配置接入开箱即用无论 Android 还是 iOS 都无需手动配 SDK 依赖、无需改原生工程文件双端统一零配置把接入成本压到最低。Android工具包已发布至 Maven 中央仓库构建工具自动拉取无需手动配置iOS依赖声明文件自动处理执行依赖安装即用Key 与隐私合规统一在 Dart 层传入亮点 2 · 代码省声明式 API贴合 Flutter 范式覆盖物点标记 / 折线 / 多边形 / 圆形采用声明式管理只需描述想要什么状态插件自动对比差异、只同步变化部分状态清晰、性能更好、代码更简洁。同时数据模型均为不可变设计契合 Flutter 习惯。亮点 3 · 走得远Compat分层架构从容应对多版本用户设备上的地图 SDK 版本可能不一样而插件则是以最低版本为编译基准Android 5.9.0 / iOS 5.7.7通过 Compat 分层 启动时能力检测缓存兼容到最新版技术架构业务代码 → XxxCompat统一接口按版本分支 → SdkCompat启动时检测一次并缓存 → TencentMap SDK5.9.0 ~ 最新版检测只在启动时做一次运行时走纯 if/else零反射开销新增差异点只需改 Compat 文件不污染业务代码。亮点 4 · 适配准渲染模式自动选择用户可选不必纠结 Android 的两种渲染方式怎么选插件默认自动按系统版本为你选择最优模式同时也支持强制指定——既兼顾性能与兼容性又把选择权交回开发者手中灵活适配各类机型与场景。enumAndroidViewMode{auto,surfaceView,textureView}亮点 5 · 跑得稳初始化时序内部封装平台细节双端一致地图 SDK 初始化步骤有严格顺序要求顺序错误会导致白屏或崩溃等问题。从隐私合规 ➡️ SDK启动 ➡️ API key ➡️ 创建地图插件将正确的初始化时序封装在内部开发者无需操心。同时坐标系、覆盖物渲染等双端差异也一并细致封装与对齐同一份代码彻底双端一致。 PART 04 · 接入前后开发者省了什么告别6件烦心事Flutter插件提高开发者生产力你以前要操心的用了这套插件后❌ 手写 MethodChannel 逐个桥接原生 API✅ 官方封装好直接调 Dart API❌ Android 配依赖、配仓库、改 Manifest✅ 双端零配置添加依赖即用❌ iOS 改 AppDelegate 初始化 SDK✅ Key 与隐私合规统一 Dart 层传入❌ 自己处理 Android / iOS API 差异✅ 上层代码双端一致差异内部消化❌ 命令式增删覆盖物、手动管状态✅ 声明式 增量更新状态可预测❌ 担心插件长期维护与更新节奏✅ 官方出品持续迭代有保障 一句话总结你写业务跨端的复杂度交给官方插件。您在使用过程中有任何问题都可前往腾讯位置服务官网「提交工单」。您还可以点击下方小程序一键成为腾讯位置服务开发者