更新记录

1.0.0（2025-11-14）

1.0.0 首次发布

平台兼容性

腾讯导航UTS插件

基于腾讯地图导航SDK实现的UTS插件，支持Android平台驾车导航功能。

功能特性

• ✅ 驾车导航路径规划
• ✅ 实时导航引导
• ✅ 导航UI界面显示
• ✅ 导航事件回调监听
• ✅ 位置更新通知
• ✅ Android平台专属优化

兼容性说明

安装方法

直接将插件导入到uni-app项目中即可。

快速开始

1. 配置开发者Key

在uni_modules/tsw-txdh-uts/utssdk/app-android/AndroidManifest.xml中配置您的腾讯地图Key：

<application>
    <meta-data 
        android:name="TencentMapSDK" 
        android:value="YOUR_TENCENT_MAP_KEY_HERE" />
</application>

2. 基本使用

<template>
  <view>
    <tenxun-nav-view ref="navView" @myevent="onNavEvent" />
    <button @click="startNavigation">开始导航</button>
  </view>
</template>

<script>

export default {

  methods: {
    async startNavigation() {
      // 1. 初始化SDK
      const success = await this.$refs.navView.initNavigation("YOUR_TENCENT_MAP_KEY");

      if (success) {
        // 2. 创建导航管理器和UI
        await this.$refs.navView.createManager();
        await this.$refs.navView.createUI();

        // 3. 路径规划
        const routeParams = {
          startLatitude: 39.9042,
          startLongitude: 116.4074,
          endLatitude: 39.9042,
          endLongitude: 116.4074
        };

        this.$refs.navView.planRoute(routeParams);
      }
    },

    onNavEvent(event) {
      // 处理导航事件
      console.log("导航事件:", event);
    }
  }
}
</script>

完整使用指南

查看详细使用说明和API文档，请参考 documentation.md 文件。

注意事项

1. 使用前需要在腾讯地图官网申请开发者Key
2. 需要在manifest.json中配置相关权限
3. 仅支持Android平台（iOS端暂未实现）
4. 需要网络和定位权限
5. 必须按顺序调用初始化方法

技术支持

• 腾讯地图Android导航SDK文档：https://lbs.qq.com/mobile/AndroidNavigationX/guide/quick_integrate
• UniApp官方文档：https://uniapp.dcloud.io/