获取开发密钥

最后更新时间:2025-03-19

1.进入网站https://lbs.qq.com/console/key.html，创建开发者账号。如果之前已经创建过，可以直接登录。

2.进入控制台，在key管理中创建新密钥，输入新key名称和验证码，勾选“已阅读并同意以上条款”，会获得对应的key。

3．进入key设置，启用产品中勾选“地图SDK”选项，在输入框中填写对应的Bundle Identifier,点击保存，完成key的申请。此时用户即可用刚创建的key了。

新建工程

第 1 步，下载并安装 Android Studio。 按照指南下载并安装 Android Studio。（注：下载地址为Google官方网站）https://developer.android.com/studio?pkg=studio

第 2 步，创建项目。 按以下步骤新建一个 Empty Activity 的应用项目。
1、启动 Android Studio。如果您看到 Welcome to Android Studio 对话框，请选择 Start a new Android Studio project，否则，请点击 Android Studio 菜单栏中的 File，然后点击 New->New Project，按提示输入您的应用名称、公司域和项目位置。 然后点击 Next。

2、选择您的应用所需的机型。 如果您不能确定自己的需要，只需选择 Phone and Tablet。然后点击 Next。

3、在“Add an activity to Mobile”对话框中选择 Empty Activity。 然后点击 Next。

4、按提示输入 Activity 名称、布局名称和标题。 使用默认值即可。 然后点击 Finish。

申请开发密钥

设置腾讯地图、导航、司乘同显KEY

开通权限后，需在AndroidMainfest⽂件中配置key，如：

<meta-data                               
android:name="TencentMapSDK"                        
android:value="官⽹申请的地图key"/>

<meta-data                     
android:name="com.tencent.map.ls.api_key"          
android:value="申请的司乘key"/>

引入SDK

1、Maven引入，在根目录的.gradle文件中添加地址：

repositories {               
    maven {                    
        url "https://oss.sonatype.org/content/groups/public"
    }
    maven{
        url "https://oss.sonatype.org/content/repositories/snapshots/"
    }
}

2、司乘同显SDK（司机端&乘客端）可联系小助手获得。

3、司乘同显SDK（司机端&乘客端）需要依赖3D地图SDK，可在官⽹进⾏3D地图SDK的下载和⼯程配置。地图⼯程配置指引：https://lbs.qq.com/android_v1/index.html ，地图key申请成功后，可在 gradle⽂件中引⽤，如：

implementation 'com.tencent.map:tencent-map-vector-sdk:x.x.x'

4、司乘同显SDK司机端需配合导航SDK使⽤，官网地址: https://lbs.qq.com/mobile/AndroidNavigationX/guide/summary。开通权限后，可在 gradle⽂件中引⽤，如：

implementation 'com.tencent.map:tencent-map-nav-sdk-core:x.x.x'

权限配置

SDK需要使用网络，访问硬件存储等系统权限，在AndroidManifest.xml文件里，添加如下权限：

<!-- 通过GPS得到精确位置 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <!-- 通过网络得到粗略位置 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <!-- 支持A-GPS辅助定位 -->
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
    <!-- 访问WiFi状态 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <!-- 修改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" />
    <!-- 读写手机SD卡权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <!-- 访问网络 -->
<uses-permission android:name="android.permission.INTERNET" />

混淆配置

在module里找到proguard-rules.pro文件，添加：

-keep class com.tencent.map.lsdriver.** { *; }
-keep class com.tencent.map.lspassenger.** { *; }
-keep class com.tencent.map.lssupport.** { *; }
# 导航/定位/检索SDK请参考其接入文档。