【Android 腾讯地图】腾讯地图开发记录 ① ( 地图基础显示

参考 腾讯官方文档 【腾讯位置服务 - Android地图SDK】 进行开发 ;一、创建应用和申请key1、创建应用进入 腾讯位置服务 控制台页面 : https://lbs.qq.com/dev/console/home ,

点击左侧的 " 应用管理 / 我的应用 " 面板 , 进入后 , 点击右上角的 " 创建应用 " 按钮 ,

设置 创建应用 的 名称 和 类型 ,

2、申请 key创建应用后 , 还需要申请 Key , 点击下图中 红色矩形框 中的 " 添加 Key " 按钮即可 ,

在 下图的页面中 , 输入 key 名称 , 选择 SDK 选项 , 在下面的输入框中 , 输入 Android 包名 ;

创建 key 成功后 , 弹出如下对话框 :

点击 " 查看我的配额 " 按钮 , 可以查看 账户的额度 , 坐标转换 10000 是不够用的 , 之后需要升级到商务版本 ;

下面的 红色矩形框 中就是本次生成的 Key ;

二、配置应用1、配置远程依赖库腾讯提供了两种导入依赖库的方式 :

手动导入 本地依赖库从 Maven 仓库下载依赖库这里选择从 Maven 仓库远程下载依赖库 ;

基础配置在 Module 下的 build.gradle 构建脚本中 的 配置

代码语言：javascript复制dependencies {

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

}腾讯地图的 版本号 可参考 最新版本号参考：https://lbs.qq.com/mobile/androidMapSDK/download/3dDownload 网址 , 最新的依赖库版本号是 5.4.1 ;

完整配置如果想要使用 腾讯地图 的 完整功能 , 推荐配置如下依赖库 :

代码语言：javascript复制dependencies {

// JSON 字符串解析库 ( 可不用 )

implementation 'com.google.code.gson:gson:2.8.5'

// Android 权限申请库 ( 可不用 )

implementation 'pub.devrel:easypermissions:2.0.1'

// 腾讯地图 依赖库

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

// 腾讯地图组件库 , 可实现 小车平移 / 点聚合 等组件功能

implementation 'com.tencent.map:sdk-utilities:1.0.9'

// 腾讯位置服务 定位依赖库

implementation 'com.tencent.map.geolocation:TencentLocationSdk-openplatform:7.5.3.2'

}如果依赖库下载出现问题 , 则配置如下 Maven 仓库 :

代码语言：javascript复制allprojects {

repositories {

maven { url "https://mirrors.tencent.com/repository/maven/tencent_public/" }

maven { url "https://mirrors.tencent.com/repository/maven/tencent_public_snapshots" }

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

maven { url "http://maven.aliyun.com/nexus/content/groups/public" }

google()

mavenCentral()

jcenter()

}

}2、配置腾讯地图 Key将上一个章节申请的 Key 拷贝下来 , 配置到 AndroidManifest.xml 中的 application 标签中 , 配置内容如下 :

代码语言：javascript复制

xmlns:tools="http://schemas.android.com/tools">

android:name="TencentMapSDK"

android:value="PH7BZ-PEMC5-XXXXX-ITJJS-XXXXX-SHFWU" />

在 application 标签中配置 如下内容 :

代码语言：javascript复制

android:name="TencentMapSDK"

android:value="PH7BZ-PEMC5-XXXXX-ITJJS-XXXXX-SHFWU" />三、地图开发1、同意隐私协议在进入地图界面之前 , 调用一次 下面的方法 , 设置 用户已同意隐私协议 , 否则无法使用 SDK , 建议给用户弹出提示框让用户选择 , 这里随便调用一下即可 ;

代码语言：javascript复制TencentMapInitializer.setAgreePrivacy(true);2、布局文件在布局文件中 , 推荐使用该 SupportMapFragment 作为地图的载体 , 该类中已经设置了 MapView 的 维护 操作 , 不需要自己手动维护 MapView 的生命周期 ;

代码语言：javascript复制

android:id="@+id/map_frag"

class="com.tencent.tencentmap.mapsdk.maps.SupportMapFragment"

android:layout_width="match_parent"

android:layout_height="wrap_content" />如果想要更细力度的控制 , 建议自己定义 SupportMapFragment 类 , 将 com.tencent.tencentmap.mapsdk.maps.SupportMapFragment 拷贝到自己的应用中进行定义 ;

3、地图显示 Activity 类设置Map 的基本显示 参考 腾讯地图 官方 示例代码中的 如下类 :

代码语言：javascript复制import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

import androidx.fragment.app.FragmentManager;

import com.tencent.map.vector.demo.R;

import com.tencent.tencentmap.mapsdk.maps.CameraUpdate;

import com.tencent.tencentmap.mapsdk.maps.CameraUpdateFactory;

import com.tencent.tencentmap.mapsdk.maps.SupportMapFragment;

import com.tencent.tencentmap.mapsdk.maps.TencentMap;

import com.tencent.tencentmap.mapsdk.maps.UiSettings;

import com.tencent.tencentmap.mapsdk.maps.model.CameraPosition;

import com.tencent.tencentmap.mapsdk.maps.model.LatLng;

public class SupportMapFragmentActivity extends AppCompatActivity {

/**

* SDK提供了SupportMapFragment这个类来加载地图，这个类的方便之处就在于不用手动管理内存

*/

private FragmentManager fm;

protected TencentMap tencentMap;

private SupportMapFragment supportMapFragment;

protected UiSettings mapUiSettings;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_support_map_fragment);

//创建tencentMap地图对象，可以完成对地图的几乎所有操作

fm = getSupportFragmentManager();

supportMapFragment = (SupportMapFragment) fm.findFragmentById(R.id.map_frag);

tencentMap = supportMapFragment.getMap();

mapUiSettings = tencentMap.getUiSettings();

//对地图操作类进行操作

CameraUpdate cameraSigma =

CameraUpdateFactory.newCameraPosition(new CameraPosition(

new LatLng(39.984066, 116.307548),

15,

0f,

0f));

//移动地图

tencentMap.moveCamera(cameraSigma);

}

}4、覆盖自定义地图图片下面的代码是设置 自定义的 地图 , 覆盖到 腾讯地图上 ;

LatLngBounds 设置的第一个坐标是 地图东北角 坐标 , 第二个坐标是 地图西南角坐标 ;

alpha 函数设置 覆盖图片 的透明度 , 一般设置为 1.0 完全不透明 即可 , 其设置范围是 0.0 - 1.0 , 0 表示完全透明 , 1 表示不透明 ;

代码语言：javascript复制LatLngBounds lb = new LatLngBounds(

new LatLng(40.045226, 116.280069),

new LatLng(40.038918, 116.271873));

groundOverlayOptions = new GroundOverlayOptions()

.bitmap(BitmapDescriptorFactory

.fromAsset("groundoverlay.jpg"))

.latLngBounds(lb)

.alpha(1.0f);

groundOverlay = mTencentMap.addGroundOverlay(groundOverlayOptions);