安卓应用开发学习：通过腾讯地图SDK实现定位功能

一、引言

这几天有些忙，耽误了写日志，但我的学习始终没有落下，有空我就会研究《 Android App 开发进阶与项目实战》一书中定位导航方面的内容。在我的手机上先后实现了“获取经纬度及地理位置描述信息”和“获取导航卫星信息”功能后，这两天，我又参照这书中的内容，实现了通过腾讯地图的Android定位SDK实现定位的功能，并有所扩展。书文以记之。

二、腾讯位置服务平台创建应用

要使用腾讯地图的位置服务，首先要到腾讯位置服务平台（https://lbs.qq.com/)注册一个用户，登录后进入控制台，在应用管理下创建自己的应用，然后添加Key。具体步骤见以下截图：

1.登录打开控制台

2.找到应用管理->我的应用，点击“创建应用”按钮。

3.输入应用的名称，并选择应用类型，确认后生成应用。

4.回到我的应用页面，点击“添加Key”。

5.输入Key名称、描述，勾选“SDK"和”导航SDK“，并在下方的文本框中输入你在Android Studio中要创建应用的包名。

6.完成，生成的Key在Android Studio中集成腾旭地图时要用到。

三、集成腾讯地图

完成上面的操作后，在Android Studio中要对需要使用腾讯位置服务的应用进行设置才能使用腾讯地图的SDK。

1.打开已创建好的Module下的build.gradle文件，在文的依赖中添加腾讯地图组件。

// 腾讯定位
implementation 'com.tencent.map.geolocation:TencentLocationSdk-openplatform:7.2.8'
// 腾讯地图
implementation 'com.tencent.map:tencent-map-vector-sdk:4.3.9.9'
// 地图组件库
implementation 'com.tencent.map:sdk-utilities:1.0.6'

上述组件的版本并不是最新的，我是照着《 Android App 开发进阶与项目实战》上输入的，组件的最新版本请到官网查询。

2.在Module的AndroidManifest.xml文件中添加权限配置。

我添加的权限是参考了《 Android App 开发进阶与项目实战》中的内容，官网给的添加权限（见下方）和我添加的有些不同，但我这边能正常定位，说明有些权限应该是可由可无的。

<!-- 通过GPS得到精确位置 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<!-- 通过网络得到粗略位置 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<!-- 访问网络，某些位置信息需要从网络服务器获取 -->
<uses-permission android:name="android.permission.INTERNET"/>
<!-- 访问WiFi状态，需要WiFi信息用于网络定位 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<!-- 修改WiFi状态，发起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"/>
<!-- 蓝牙扫描权限 -->
<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
<!-- 前台service权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
<!-- 后台定位权限 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>
<!-- A-GPS辅助定位权限，方便GPS快速准确定位 -->
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS"/>

3. 在AndroidManifest.xml文件的application节点中添加一行属性配置：

android:usesCleartextTraffic="true"

4.最后，在AndroidManifest.xml文件的application节点末尾添加名为TencentMapSDK的元数据，之前在官网平台上生成的Key就填在这里。

以上就是我的设置步骤，全部是参考《 Android App 开发进阶与项目实战》中的内容，与官网的步骤有所区别（官网设置连接），但我的应用实现腾讯地图定位没有遇到问题。

四、功能实现

我是参照《 Android App 开发进阶与项目实战》书中9.3.2 显示地图面板的内容，创建的Activity可以在腾讯地图上显示手机所在的位置，并能在普通地图和卫星地图之间切换，还可以显示交通情况。另外，可以通过手势操作移动地图和缩放地图。其功能与微信中共享位置功能差不多。

（普通地图模式）（卫星地图+显示交通情况模式）

对书中的源码研究后，我决定再扩展一下，增加SDK自带的指南针图标，自己自定义的放大按钮、缩小按钮、回到手机所在位置按钮，另外还自定义一个显示地图中心图标且显示中心经纬度的功能。最终效果如下：

1. 普通地图模式

这是照搬的书中的源码，点击“普通”单选按钮，将地图类型设置为TencentMap.MAP_TYPE_NORMAL。进入地图后默认也是这个类型。关键代码：

private TencentMap mTencentMap; // 声明一个腾讯地图对象
private MapView mMapView; // 声明一个地图视图对象

// onCreate方法中初始化
mMapView = findViewById(R.id.mapView);
mTencentMap = mMapView.getMap(); // 获取腾讯地图对象

// 点击“普通地图”单选按钮后，执行以下语句
mTencentMap.setMapType(TencentMap.MAP_TYPE_NORMAL); // 设置普通地图

2.卫星地图模式

通过点击“卫星”单选按钮触发。关键代码：

// 点击“卫星地图”单选按钮后，执行以下语句
mTencentMap.setMapType(TencentMap.MAP_TYPE_SATELLITE); // 设置卫星地图

3. 显示交通情况

通过点击“交通情况”复选按钮触发，关键代码：

// 点击“交通情况”复选按钮触发
mTencentMap.setTrafficEnabled(isChecked); // 是否显示交通拥堵状况

4. 显示/隐藏中心点标记

这是我自己添加的功能，红色十字图标是一个TextView组件，这个组件与腾讯地图组件MapView都放在一个RelativeLayout布局中，MapView充满整个布局，TextView放在RelativeLayout中心位置。在onCreate方法初始化时，将这个TextView组件隐藏，在勾选了复选框后，才显示，另外“中心点”按钮，也与这个TextView联动，在TextView组件显示时“中心点”按钮可用，在TextView组件隐藏时“中心点”按钮不可用。

关键代码：

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1" >

        <com.tencent.tencentmap.mapsdk.maps.MapView
            android:id="@+id/mapView"
            android:layout_width="match_parent"
            android:layout_height="fill_parent" />

        <TextView
            android:id="@+id/tv_centerPoint"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center"
            android:gravity="center"
            android:layout_centerInParent="true"
            android:textSize="48sp"
            android:textColor="@color/red"
            android:text="+" />
    </RelativeLayout>

private Button btn_getCenter;  // 获取中心点按钮
private TextView tv_centerPoint; // 中心点标记


// 点“中心点”按钮左侧的复选框后，显示
tv_centerPoint.setVisibility(View.VISIBLE);  // 显示
btn_getCenter.setEnabled(true);  // 可用


// 取消“中心点”按钮左侧的复选框后，隐藏
tv_centerPoint.setVisibility(View.INVISIBLE);  // 隐藏
btn_getCenter.setEnabled(false);  // 不可用

5. 获取中心点位置

在“中心点”按钮左侧的复选框勾选的情况下，点击“中心点”按钮，会显示中心点标识，且获取地图中心点经纬度，并显示在界面中。关键代码如下：

CameraPosition cameraPosition = mTencentMap.getCameraPosition();
mCenterLatLng = cameraPosition.target;
Toast.makeText(this, "中心点坐标：" + mCenterLatLng.latitude + ";" + mCenterLatLng.longitude, Toast.LENGTH_LONG).show();

6. 放大/缩小地图

（点击放大按钮效果) (点击缩小按钮效果）

放大和缩小按钮时参考了其它地图软件上的效果，我自己用带圆角样式的LinearLayout布局包裹了两个TextView组件实现的。这个LinearLayout布局也是放在前面说到的RelativeLayout布局中。LinearLayout布局位于地图组件的右下方向。两个TextView组件设置了OnClick监听器，点击后执行放大和缩小地图操作。关键代码：

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1" >

        <com.tencent.tencentmap.mapsdk.maps.MapView
            android:id="@+id/mapView"
            android:layout_width="match_parent"
            android:layout_height="fill_parent" />

        <LinearLayout
            android:layout_width="55dp"
            android:layout_height="wrap_content"
            android:layout_above="@+id/mapView"
            android:layout_alignEnd="@+id/mapView"
            android:layout_alignBottom="@+id/mapView"
            android:layout_marginEnd="20dp"
            android:layout_marginBottom="110dp"
            android:background="@drawable/radius_border_15"
            android:orientation="vertical">

            <TextView
                android:id="@+id/tv_enlarge"
                android:layout_width="50dp"
                android:layout_height="50dp"
                android:layout_gravity="center_horizontal"
                android:layout_marginTop="15dp"
                android:layout_marginBottom="15dp"
                android:gravity="center"
                android:text="+"
                android:textColor="@color/black"
                android:textSize="32sp"
                android:textStyle="bold" />

            <TextView
                android:id="@+id/tv_narrow"
                android:layout_width="50dp"
                android:layout_height="50dp"
                android:layout_gravity="center_horizontal"
                android:layout_marginTop="15dp"
                android:layout_marginBottom="15dp"
                android:gravity="center"
                android:text="-"
                android:textColor="@color/black"
                android:textSize="32sp"
                android:textStyle="bold" />

        </LinearLayout>
    </RelativeLayout>

// 点击放大按钮后执行
mTencentMap.moveCamera(CameraUpdateFactory.zoomIn()); // 放大一级
// 点击缩小按钮后执行
mTencentMap.moveCamera(CameraUpdateFactory.zoomOut()); // 缩小一级

7. 回到手机定位处

在地图中通过手指拖动地图，使手机定位脱离地图中心点后，通过点击“回到手机处”按钮就可以将地图的中心点重新设置为手机定位处，从而让地图中心点快速回到定位处。

这个图标是我从手机的百度地图上截图后，通过PS处理后得到的，保存为PNG格式后，放在项目的res/drawable-xhdpi文件夹下。在xml文件中这个图标放在ImageButton组件中，这个组件外套了一个带圆角的LinearLayout布局。LinearLayout布局放在RelativeLayout布局中，设置在mapView组件的左下方。

关键代码：

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1" >

        <com.tencent.tencentmap.mapsdk.maps.MapView
            android:id="@+id/mapView"
            android:layout_width="match_parent"
            android:layout_height="fill_parent" />
        <LinearLayout
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignStart="@+id/mapView"
            android:layout_alignBottom="@+id/mapView"
            android:background="@drawable/radius_border_15"
            android:layout_marginStart="20dp"
            android:layout_marginBottom="50dp"
            android:orientation="horizontal">

            <ImageButton
                android:id="@+id/img_btn_myPlace"
                android:layout_width="54dp"
                android:layout_height="54dp"
                android:backgroundTint="@color/white"
                android:src="@drawable/ic_my_place"
                tools:ignore="ContentDescription" />
        </LinearLayout>
    </RelativeLayout>

// 点击“中心点”按钮后，执行
CameraPosition cameraPosition = mTencentMap.getCameraPosition();
mCenterLatLng = cameraPosition.target;
Toast.makeText(this, "中心点坐标：" + mCenterLatLng.latitude + ";" + mCenterLatLng.longitude, Toast.LENGTH_LONG).show();

8.添加指南针

这是腾讯地图自带的组件，只需要在onCreate方法中添加几行代码就可以：

mTencentMap = mMapView.getMap(); // 获取腾讯地图对象

// 在上面的语句获取到地图对象后，添加以下两行代码
UiSettings mysetting = mTencentMap.getUiSettings();
mysetting.setCompassEnabled(true);  // 开启指南针

五、代码展示

最后上完整的代码，希望对大家有用：

MapBasicActivity.Java文件

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.CheckBox;
import android.widget.RadioGroup;
import android.widget.TextView;
import android.widget.Toast;

import com.tencent.map.geolocation.TencentLocation;
import com.tencent.map.geolocation.TencentLocationListener;
import com.tencent.map.geolocation.TencentLocationManager;
import com.tencent.map.geolocation.TencentLocationRequest;
import com.tencent.tencentmap.mapsdk.maps.CameraUpdate;
import com.tencent.tencentmap.mapsdk.maps.CameraUpdateFactory;
import com.tencent.tencentmap.mapsdk.maps.MapView;
import com.tencent.tencentmap.mapsdk.maps.TencentMap;
import com.tencent.tencentmap.mapsdk.maps.UiSettings;
import com.tencent.tencentmap.mapsdk.maps.model.BitmapDescriptor;
import com.tencent.tencentmap.mapsdk.maps.model.BitmapDescriptorFactory;
import com.tencent.tencentmap.mapsdk.maps.model.CameraPosition;
import com.tencent.tencentmap.mapsdk.maps.model.LatLng;
import com.tencent.tencentmap.mapsdk.maps.model.MarkerOptions;

public class MapBasicActivity extends AppCompatActivity implements TencentLocationListener, View.OnClickListener {
    private final static String TAG = "MapBasicActivity";
    private TencentLocationManager mLocationManager; // 声明一个腾讯定位管理器对象
    private MapView mMapView; // 声明一个地图视图对象
    private TencentMap mTencentMap; // 声明一个腾讯地图对象
    private boolean isFirstLoc = true; // 是否首次定位
    private Button btn_getCenter;  // 获取中心点按钮
    private TextView tv_centerPoint; // 中心点标记
    private LatLng mMyLatLng, mCenterLatLng;  // 我的位置， 地图中心位置

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_map_basic);
        initLocation(); // 初始化定位服务
        initView(); // 初始化视图
    }

    // 初始化视图
    private void initView() {
        tv_centerPoint = findViewById(R.id.tv_centerPoint);
        tv_centerPoint.setVisibility(View.INVISIBLE);
        btn_getCenter = findViewById(R.id.btn_getCenter);
        btn_getCenter.setEnabled(false);
        RadioGroup rg_type = findViewById(R.id.rg_type);
        rg_type.setOnCheckedChangeListener((group, checkedId) -> {
            if (checkedId == R.id.rb_common) {
                mTencentMap.setMapType(TencentMap.MAP_TYPE_NORMAL); // 设置普通地图
            } else if (checkedId == R.id.rb_satellite) {
                mTencentMap.setMapType(TencentMap.MAP_TYPE_SATELLITE); // 设置卫星地图
            }
        });
        CheckBox ck_traffic = findViewById(R.id.ck_traffic);
        ck_traffic.setOnCheckedChangeListener((buttonView, isChecked) -> {
            mTencentMap.setTrafficEnabled(isChecked); // 是否显示交通拥堵状况
        });
        CheckBox ck_centerPoint = findViewById(R.id.ck_centerPoint);
        ck_centerPoint.setOnCheckedChangeListener((buttonView, isChecked) -> {
            if (isChecked) {
                tv_centerPoint.setVisibility(View.VISIBLE);
                btn_getCenter.setEnabled(true);
            } else {
                tv_centerPoint.setVisibility(View.INVISIBLE);
                btn_getCenter.setEnabled(false);
            }
        });
        // 设置按钮监听器
        findViewById(R.id.tv_enlarge).setOnClickListener(this);  // 放大地图
        findViewById(R.id.tv_narrow).setOnClickListener(this);  // 缩小地图
        findViewById(R.id.img_btn_myPlace).setOnClickListener(this);  // 回到我的位置
        findViewById(R.id.btn_getCenter).setOnClickListener(this);  // 获取中心点
        btn_getCenter.setOnClickListener(this);  // 获取中心点
    }

    // 初始化定位服务
    private void initLocation() {
        mMapView = findViewById(R.id.mapView);
        mTencentMap = mMapView.getMap(); // 获取腾讯地图对象
        UiSettings mysetting = mTencentMap.getUiSettings();
        mysetting.setCompassEnabled(true);  // 开启指南针
        mLocationManager = TencentLocationManager.getInstance(this);
        // 创建腾讯定位请求对象
        TencentLocationRequest request = TencentLocationRequest.create();
        request.setInterval(30000).setAllowGPS(true);
        request.setRequestLevel(TencentLocationRequest.REQUEST_LEVEL_ADMIN_AREA);
        mLocationManager.requestLocationUpdates(request, this); // 开始定位监听
    }

    @Override
    public void onLocationChanged(TencentLocation location, int resultCode, String resultDesc) {
        if (resultCode == TencentLocation.ERROR_OK) { // 定位成功
            if (location != null && isFirstLoc) { // 首次定位
                isFirstLoc = false;
                // 创建一个经纬度对象
                mMyLatLng = new LatLng(location.getLatitude(), location.getLongitude());
                CameraUpdate update = CameraUpdateFactory.newLatLngZoom(mMyLatLng, 12);
                mTencentMap.moveCamera(update); // 把相机视角移动到指定地点
                // 从指定图片中获取位图描述
                BitmapDescriptor bitmapDesc = BitmapDescriptorFactory
                        .fromResource(R.drawable.icon_locate);
                MarkerOptions ooMarker = new MarkerOptions(mMyLatLng).draggable(false) // 不可拖动
                        .visible(true).icon(bitmapDesc).snippet("这是您的当前位置");
                mTencentMap.addMarker(ooMarker); // 往地图添加标记
            }
        } else { // 定位失败
            Log.d(TAG, "定位失败，错误代码为"+resultCode+"，错误描述为"+resultDesc);
        }
    }

    @Override
    public void onStatusUpdate(String s, int i, String s1) {}
    // 绑定生命周期
    @Override
    protected void onStart() {
        super.onStart();
        mMapView.onStart();
    }

    @Override
    protected void onStop() {
        super.onStop();
        mMapView.onStop();
    }

    @Override
    public void onPause() {
        super.onPause();
        mMapView.onPause();
    }

    @Override
    public void onResume() {
        super.onResume();
        mMapView.onResume();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        mLocationManager.removeUpdates(this); // 移除定位监听
        mMapView.onDestroy();
    }

    @Override
    public void onClick(View v) {
        if (v.getId() == R.id.tv_enlarge) {  // 放大地图
            mTencentMap.moveCamera(CameraUpdateFactory.zoomIn()); // 放大一级
        } else if (v.getId() == R.id.tv_narrow) {  // 缩小地图
            mTencentMap.moveCamera(CameraUpdateFactory.zoomOut()); // 缩小一级
        } else if (v.getId() == R.id.img_btn_myPlace) {  // 回到我的位置
            CameraUpdate update = CameraUpdateFactory.newLatLng(mMyLatLng);
            mTencentMap.moveCamera(update); // 把相机视角移动到指定地点
        } else if (v.getId() == R.id.btn_getCenter) {  // 获取中心点坐标
            CameraPosition cameraPosition = mTencentMap.getCameraPosition();
            mCenterLatLng = cameraPosition.target;
            Toast.makeText(this, "中心点坐标：" + mCenterLatLng.latitude + ";" + mCenterLatLng.longitude, Toast.LENGTH_LONG).show();
        }
    }
}

activity_map_basic.xml文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context=".MapBasicActivity">

    <RadioGroup
        android:id="@+id/rg_type"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal" >

        <RadioButton
            android:id="@+id/rb_common"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:checked="true"
            android:text="普通"
            android:textColor="@color/black"
            android:textSize="17sp" />

        <RadioButton
            android:id="@+id/rb_satellite"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:checked="false"
            android:text="卫星"
            android:textColor="@color/black"
            android:textSize="17sp" />

        <CheckBox
            android:id="@+id/ck_traffic"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:checked="false"
            android:text="交通情况"
            android:textColor="@color/black"
            android:textSize="17sp" />

        <CheckBox
            android:id="@+id/ck_centerPoint"
            android:layout_width="35dp"
            android:layout_height="wrap_content"
            android:layout_marginStart="10dp"
            android:checked="false"
            android:text=""
            android:textColor="@color/black"
            android:textSize="17sp" />

        <Button
            android:id="@+id/btn_getCenter"
            android:layout_width="80dp"
            android:layout_height="wrap_content"
            android:text="中心点"/>
    </RadioGroup>


    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1" >

        <com.tencent.tencentmap.mapsdk.maps.MapView
            android:id="@+id/mapView"
            android:layout_width="match_parent"
            android:layout_height="fill_parent" />

        <LinearLayout
            android:layout_width="55dp"
            android:layout_height="wrap_content"
            android:layout_above="@+id/mapView"
            android:layout_alignEnd="@+id/mapView"
            android:layout_alignBottom="@+id/mapView"
            android:layout_marginEnd="20dp"
            android:layout_marginBottom="110dp"
            android:background="@drawable/radius_border_15"
            android:orientation="vertical">

            <TextView
                android:id="@+id/tv_enlarge"
                android:layout_width="50dp"
                android:layout_height="50dp"
                android:layout_gravity="center_horizontal"
                android:layout_marginTop="15dp"
                android:layout_marginBottom="15dp"
                android:gravity="center"
                android:text="+"
                android:textColor="@color/black"
                android:textSize="32sp"
                android:textStyle="bold" />

            <TextView
                android:id="@+id/tv_narrow"
                android:layout_width="50dp"
                android:layout_height="50dp"
                android:layout_gravity="center_horizontal"
                android:layout_marginTop="15dp"
                android:layout_marginBottom="15dp"
                android:gravity="center"
                android:text="-"
                android:textColor="@color/black"
                android:textSize="32sp"
                android:textStyle="bold" />

        </LinearLayout>

        <LinearLayout
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignStart="@+id/mapView"
            android:layout_alignBottom="@+id/mapView"
            android:background="@drawable/radius_border_15"
            android:layout_marginStart="20dp"
            android:layout_marginBottom="50dp"
            android:orientation="horizontal">

            <ImageButton
                android:id="@+id/img_btn_myPlace"
                android:layout_width="54dp"
                android:layout_height="54dp"
                android:backgroundTint="@color/white"
                android:src="@drawable/ic_my_place"
                tools:ignore="ContentDescription" />
        </LinearLayout>

        <TextView
            android:id="@+id/tv_centerPoint"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center"
            android:gravity="center"
            android:layout_centerInParent="true"
            android:textSize="48sp"
            android:textColor="@color/red"
            android:text="+" />

    </RelativeLayout>

</LinearLayout>