【Android 腾讯地图】腾讯地图开发记录 ① ( 地图基础显示 | 创建应用和申请key | 配置远程依赖库 | 配置腾讯地图 Key | 同意隐私协议 | 布局设置 | 覆盖自定义地图图片 )
【Android 腾讯地图】腾讯地图开发记录 ① ( 地图基础显示 | 创建应用和申请key | 配置远程依赖库 | 配置腾讯地图 Key | 同意隐私协议 | 布局设置 | 覆盖自定义地图图片 )
参考 腾讯官方文档 【腾讯位置服务 - Android地图SDK】 进行开发 ;
一、创建应用和申请key
1、创建应用
进入 腾讯位置服务 控制台页面 : https://lbs.qq.com/dev/console/home ,
点击左侧的 " 应用管理 / 我的应用 " 面板 , 进入后 , 点击右上角的 " 创建应用 " 按钮 ,
设置 创建应用 的 名称 和 类型 ,
2、申请 key
创建应用后 , 还需要申请 Key , 点击下图中 红色矩形框 中的 " 添加 Key " 按钮即可 ,
在 下图的页面中 , 输入 key 名称 , 选择 SDK 选项 , 在下面的输入框中 , 输入 Android 包名 ;
创建 key 成功后 , 弹出如下对话框 :
点击 " 查看我的配额 " 按钮 , 可以查看 账户的额度 , 坐标转换 10000 是不够用的 , 之后需要升级到商务版本 ;
下面的 红色矩形框 中就是本次生成的 Key ;
二、配置应用
1、配置远程依赖库
腾讯提供了两种导入依赖库的方式 :
- 手动导入 本地依赖库
- 从 Maven 仓库下载依赖库
这里选择从 Maven 仓库远程下载依赖库 ;
基础配置
在 Module 下的 build.gradle 构建脚本中 的 配置
dependencies {
implementation 'com.tencent.map:tencent-map-vector-sdk:5.4.1'
}腾讯地图的 版本号 可参考 最新版本号参考：https://lbs.qq.com/mobile/androidMapSDK/download/3dDownload 网址 , 最新的依赖库版本号是 5.4.1 ;
完整配置
如果想要使用 腾讯地图 的 完整功能 , 推荐配置如下依赖库 :
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 仓库 :
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 标签中 , 配置内容如下 :
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools">
<application>
<!-- 腾讯地图 Key -->
<meta-data
android:name="TencentMapSDK"
android:value="PH7BZ-PEMC5-XXXXX-ITJJS-XXXXX-SHFWU" />
</application>
</manifest>在 application 标签中配置 如下内容 :
<!-- 腾讯地图 Key -->
<meta-data
android:name="TencentMapSDK"
android:value="PH7BZ-PEMC5-XXXXX-ITJJS-XXXXX-SHFWU" />三、地图开发
1、同意隐私协议
在进入地图界面之前 , 调用一次 下面的方法 , 设置 用户已同意隐私协议 , 否则无法使用 SDK , 建议给用户弹出提示框让用户选择 , 这里随便调用一下即可 ;
TencentMapInitializer.setAgreePrivacy(true);2、布局文件
在布局文件中 , 推荐使用该 SupportMapFragment 作为地图的载体 , 该类中已经设置了 MapView 的 维护 操作 , 不需要自己手动维护 MapView 的生命周期 ;
<fragment
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 的基本显示 参考 腾讯地图 官方 示例代码中的 如下类 :
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 表示不透明 ;
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);