Android 百度地图SDK 自动定位、标记定位

先看效果图,如果不是你想要的，也就不浪费你时间了，这样对大家都好。

Android 百度地图SDK 自动定位、标记定位

一、创建项目引入SDK
- ① 获取开发版SHA1
- - 1. Android Studio 3.5.2版本
  - 2. Android Studio 4.2.1 版本
  - 3. Android Studio Dolphin | 2021.3.1版本
- ② 获取发布版SHA1
二、显示地图
三、定位当前所在位置
四、标点定位、回到原位
五、权限问题
- ① 动态权限请求
六、源码

一、创建项目引入SDK

如果是你满意的那样，我们就可以开始写了，首先创建一个名为MapDemo的项目。打开AndroidManifest.xml，复制你的包名，（注意新版本Android Studio中可能这里找不到包名了，那么就去你的app的build.gradle中去寻找。）

然后进入百度地图开放平台，没有注册的小伙伴先注册，已注册的就直接登录，登录进去之后找到控制台→我的应用→创建应用

点击之后进入,填写相关资料。

输入了应用名称、选择了应用类型和启用的服务，输入了包名。还差开发版和发布版的SHA1了。

① 获取开发版SHA1

获取开发版SHA1可谓是一波三折，在我当时写文章的时候用的是Android Studio 3.5.2版本、后面更新到Android Studio 4.2.1 版本、现在又是Android Studio Dolphin | 2021.3.1版本。

所以下面将对三个版本获取开发版SHA1分别进行说明，这里再说明一点，三个方式有一个能用就行，建议使用第三种方式。

1. Android Studio 3.5.2版本

鼠标点击右侧边栏的Gradle→ app→Tasks→ android→ 双击signingReport

2. Android Studio 4.2.1 版本

当你的AS版本为最新版时，你会发现这里好像有点不一样了，找不到signingReport了，这是AS更新之后默认这个功能关掉了，需要去手动打开它，在设置里面。

如下图这里默认勾选上了，现在把这根勾选上的去掉。

然后Sync，或者点击这个小图标。

然后你的项目的右侧边栏就会出现这个熟悉的task了。

3. Android Studio Dolphin | 2021.3.1版本

这个版本中，上述两个版本的方式无法操作（我目前没有找到相应的方式），因此我们使用指令来获取，这种方式在前面两个版本中，也可以使用，缺点就是稍微有一点麻烦，你需要先在环境变量中配置Java JDK版本，然后再使用指令，配置JDK的话就用11或以上版本就可以了，JDK的安装配置就不用我再多说了吧。下面进行调试版SHA1的获取，Win + R ，输入cmd，进入命令窗口。

输入

cd .android

回车

先切换到.android目录下，然后输入

keytool -list -v -keystore debug.keystore

回车之后会让你输入密钥，默认的密钥就是android，你输入的时候是不可见的，光标也不会有反应，你只管输入就行，输入完回车就能看到SHA1了，如下图所示。

粘贴到开发版SHA1的输入框

② 获取发布版SHA1

Build → Generate Signed Bundle or APK

选择APK 点击Next

这里是没有秘钥的，需要创建一个新的秘钥，点击 Create New…

先创建项目的jks文件,点击右侧的文件夹图标，指定对应的文件

没有文件夹就先自己创建一个，选择好文件夹之后，输入jks的名字，这里你可以自己取名，然后点击OK。

输入密码，点击OK。

别管这个，点击OK（这个Error弹窗在新版本AS中不会出现。）

勾选上记住密码，然后OK。

下面还有一个地方要改一下就是APK生成的位置，我不希望它生成在项目里面的默认文件夹，因为找起来不方便，还有一个原因就是clean Project的时候会删除掉你的APK，不管是调试版还是发布版，点击那个小文件夹进行路径修改。

这里的V1和V2，在新版本中是没有的，就不用勾选了。选中APK,点击创建文件图标，新建一个子文件夹。

输入文件夹名称，点击OK。

然后选中这个刚创建的文件夹,点击Finish。

这个时候，底部会出现一个进度条，表示在生成APK文件，然后底部右侧出现这个这个提示弹窗表示，生成APK成功。

然后找到这个APK的所在目录

这个就是你生成的APK所在地址。以你自己前面设置的路径为准。接下来进入Android Studio的Terminal工具输入如下图所示的命令和jks存放路径。

//如果你前面的步骤和我一模一样的话，这里你就可以复制粘贴，不一样的话就修改jks的路径就可以了
keytool -list -v -keystore D:\APK\mapdemo.jks

输入这行命令之后回车会让你输入密码，就是之前创建秘钥的的那个密码，输入的过程中你是看不见密码的，光标也不会移动，不过不用担心，输入无误后回车就可以了。

找到这个SHA1，然后复制，粘贴到发布版SHA1的输入框里

那么这个页面的所需资料就填写完毕，点击提交

应用创建成功

点击开发文档选择Android地图SDK

点击去下载，（注意，如果你的版本比我文章中的要新一些，那么你在编码过程中要去官网查看是否有什么新的设置，很多人在这里栽了，请注意。）

选择Jar，这里我们只需要定位和地图就可以了。

下载开发包

下载后解压文件夹，进入libs里面

复制这些文件，然后进入你的Android Studio,切换到Project模式，找到libs，然后粘贴。

打开build.gradle，复制如下代码进去，注意放置的位置是在android闭包中，然后Sync，保存修改配置文件

 sourceSets{main{jniLibs.srcDir 'libs'jni.srcDirs = []    //disable automatic ndk-build}}

然后检查一下你的dependencies{}闭包下有没有这样一行代码。

implementation fileTree(dir: 'libs', include: ['*.jar'])

新版本AS中没有这行代码，记得加上，没有的话会造成你的SDK导入不成功，从而你就使用不了，然后你就会来找我问为什么，这个问题我已经回答的几百次了。

都配置好之后，点击Sync Now，编译工程，配置成功，jar包就是可以展开的。

然后进入开放平台，复制你的应用AK。

二、显示地图

切换到Android文件模式，打开AndroidManifest.xml,在application标签下写入

     <!--百度定位AK--><meta-dataandroid:name="com.baidu.lbsapi.API_KEY"android:value="WpVg5eIh4kYWPHtPjG3arHIf6bGEn49s" />

注意这个value里面的值是你自己的应用的，你用我的是没用的。
然后放入定位服务

     <!--百度定位服务  这个服务也是放在application标签下的--><serviceandroid:name="com.baidu.location.f"android:enabled="true"android:process=":remote" />

最后放入权限

 <!--以下权限与application标签是平级的--><!-- 这个权限用于进行网络定位--><uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /><!-- 这个权限用于访问GPS定位--><uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /><!-- 用于访问wifi网络信息，wifi信息会用于进行网络定位--><uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /><!-- 获取运营商信息，用于支持提供运营商信息相关的接口--><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><!-- 这个权限用于获取wifi的获取权限，wifi信息会用来进行网络定位--><uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /><!-- 写入扩展存储，向扩展卡写入数据，用于写入离线定位数据--><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /><!-- 访问网络，网络定位需要上网--><uses-permission android:name="android.permission.INTERNET" />

创建一个MapApplication类，继承Application，在onCreate方法中完成SDK的初始化，代码如下：

package com.llw.mapdemo;import android.app.Application;import com.baidu.mapapi.CoordType;
import com.baidu.mapapi.SDKInitializer;
import com.baidu.mapapi.common.BaiduMapSDKException;public class MapApplication extends Application {@Overridepublic void onCreate() {super.onCreate();//在使用SDK各组件之前初始化context信息，传入ApplicationContextSDKInitializer.setAgreePrivacy(this, true);try {// 在使用 SDK 各组间之前初始化 context 信息，传入 ApplicationContextSDKInitializer.initialize(this);SDKInitializer.setCoordType(CoordType.BD09LL);} catch (BaiduMapSDKException e) {e.printStackTrace();}}
}

然后在AndroidManifest.xml文件中声明该Application

现在修改activity_main.xml文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"xmlns:tools="http://schemas.android.com/tools"android:layout_width="match_parent"android:layout_height="match_parent"tools:context=".MainActivity"><com.baidu.mapapi.map.MapViewandroid:id="@+id/bmapView"android:layout_width="match_parent"android:layout_height="match_parent"android:clickable="true" /></LinearLayout>

然后在MainActivity中

这个时候你的地图就会显示出来，可能会比较慢，这个与网络有关。运行起来

SDK默认指定了北京的坐标，那么这肯定不是你想要的，所以要定位到实际的位置才行。

三、定位当前所在位置

修改一下styles.xml文件。

进入MainActivity。

initLocation方法代码如下：

 /*** 定位初始化*/public void initLocation() {//添加隐私合规政策LocationClient.setAgreePrivacy(true);// 开启定位图层mBaiduMap.setMyLocationEnabled(true);// 定位初始化if (mLocClient == null) {try {mLocClient = new LocationClient(this);} catch (Exception e) {e.printStackTrace();}}if (mLocClient != null) {MyLocationListener myListener = new MyLocationListener();mLocClient.registerLocationListener(myListener);LocationClientOption option = new LocationClientOption();option.setLocationMode(LocationClientOption.LocationMode.Hight_Accuracy);// 设置高精度定位option.setCoorType("bd09ll");//可选，默认gcj02，设置返回的定位结果坐标系option.setScanSpan(0);//可选，默认0，即仅定位一次，设置发起定位请求的间隔需要大于等于1000ms才是有效的option.setIsNeedAddress(true);//可选，设置是否需要地址信息，默认不需要option.setIsNeedLocationDescribe(true);//可选，默认false，设置是否需要位置语义化结果，可以在BDLocation.getLocationDescribe里得到，结果类似于“在北京天安门附近”option.setIsNeedLocationPoiList(true);//可选，默认false，设置是否需要POI结果，可以在BDLocation.getPoiList里得到option.setIgnoreKillProcess(false);//可选，默认false，定位SDK内部是一个SERVICE，并放到了独立进程，设置是否在stop的时候杀死这个进程，默认杀死option.SetIgnoreCacheException(false);//可选，默认false，设置是否收集CRASH信息，默认收集mLocClient.setLocOption(option);mLocClient.start();//开始定位}}

MyLocationListener 代码如下：

 /*** 定位SDK监听函数*/public class MyLocationListener extends BDAbstractLocationListener {@Overridepublic void onReceiveLocation(BDLocation location) {// MapView 销毁后不在处理新接收的位置if (mMapView == null) {return;}MyLocationData locData = new MyLocationData.Builder().accuracy(location.getRadius())// 设置定位数据的精度信息，单位：米.direction(location.getDirection()) // 此处设置开发者获取到的方向信息，顺时针0-360.latitude(location.getLatitude()).longitude(location.getLongitude()).build();// 设置定位数据, 只有先允许定位图层后设置数据才会生效mBaiduMap.setMyLocationData(locData);if (isFirstLoc) {isFirstLoc = false;LatLng latLng = new LatLng(location.getLatitude(), location.getLongitude());MapStatus.Builder builder = new MapStatus.Builder();builder.target(latLng).zoom(20.0f);mBaiduMap.animateMapStatus(MapStatusUpdateFactory.newMapStatus(builder.build()));}}}

最后改动一下onDestroy

 @Overrideprotected void onDestroy() {super.onDestroy();// 退出时销毁定位mLocClient.stop();// 关闭定位图层mBaiduMap.setMyLocationEnabled(false);// 在activity执行onDestroy时必须调用mMapView.onDestroy()mMapView.onDestroy();}

运行效果如下图所示

现在就已经在地图上定位到当前所在位置了。当然光是定位到自己的位置也是不够的，我还希望点击地图的时候能够定位过去。

四、标点定位、回到原位

先修改MainActivity.xml文件，根布局改为RelativeLayout，然后增加一个ImageButton控件。

里面用到的图标

写完之后你会发现，你少了一个resetLocation方法,进入MainActivity,写下如下方法：

 /*** 点切换到其他标点位置时，重置定位显示，点击之后回到自动定位** @param view*/public void resetLocation(View view) {}

然后在MainActivity中

既然要定位到其他地方肯定是要先点击地图的，所以写一个地图的点击方法

 /*** 地图点击*/private void mapOnClick() {// 设置marker图标bitmap = BitmapDescriptorFactory.fromResource(R.drawable.icon_marka);mBaiduMap.setOnMapClickListener(new BaiduMap.OnMapClickListener() {@Overridepublic void onMapPoiClick(MapPoi mapPoi) {}//此方法就是点击地图监听@Overridepublic void onMapClick(LatLng latLng) {//获取经纬度markerLatitude = latLng.latitude;markerLongitude = latLng.longitude;//先清除图层mBaiduMap.clear();// 定义Maker坐标点LatLng point = new LatLng(markerLatitude, markerLongitude);// 构建MarkerOption，用于在地图上添加MarkerMarkerOptions options = new MarkerOptions().position(point).icon(bitmap);// 在地图上添加Marker，并显示//mBaiduMap.addOverlay(options);marker = (Marker) mBaiduMap.addOverlay(options);Bundle bundle = new Bundle();bundle.putSerializable("info", "纬度：" + markerLatitude + "   经度：" + markerLongitude);marker.setExtraInfo(bundle);//将bundle值传入marker中，给baiduMap设置监听时可以得到它//点击地图之后重新定位initLocation();}});}

这里面有一个图标icon_marka

上面的代码很明确了吧，当点击地图时添加一个标点，同时绑定它的经纬度，当点击标点的时候就会显示出经纬度。当标点在地图上绘制之后，就重新定位。

下面看MyLocationListener，这里面我增加定位后的监听。

 public class MyLocationListener extends BDAbstractLocationListener {@Overridepublic void onReceiveLocation(BDLocation location){Toast.makeText(MainActivity.this, location.getAddrStr(), Toast.LENGTH_SHORT).show();// MapView 销毁后不在处理新接收的位置if (mMapView == null) {return;}double resultLatitude;double resultLongitude;if (markerLatitude == 0) {//自动定位resultLatitude = location.getLatitude();resultLongitude = location.getLongitude();ibLocation.setVisibility(View.GONE);} else {//标点定位resultLatitude = markerLatitude;resultLongitude = markerLongitude;ibLocation.setVisibility(View.VISIBLE);}MyLocationData locData = new MyLocationData.Builder().accuracy(location.getRadius())// 设置定位数据的精度信息，单位：米.direction(location.getDirection()) // 此处设置开发者获取到的方向信息，顺时针0-360.latitude(resultLatitude).longitude(resultLongitude).build();mBaiduMap.setMyLocationData(locData);// 设置定位数据, 只有先允许定位图层后设置数据才会生效LatLng latLng = new LatLng(resultLatitude, resultLongitude);MapStatus.Builder builder = new MapStatus.Builder();builder.target(latLng).zoom(20.0f);mBaiduMap.animateMapStatus(MapStatusUpdateFactory.newMapStatus(builder.build()));}}

在一开始我生命两个double类型的变量，分别是标点的经度和纬度，当一开始进来的时候判断是否等于0，如果是，则使用自动的定位，如果不是，则使用标点的定位，我在点击地图时，将获得的位置坐标赋值给了这两个变量，所以当你点击其他地方的时候就会马上定位过去。这时候就要显示出重置定位这个图标，在手机屏幕的左下角。

然后在这个定位图标的点击时写入如下代码。

 /*** 点切换到其他标点位置时，重置定位显示，点击之后回到自动定位** @param view*/public void resetLocation(View view) {markerLatitude = 0;initLocation();marker.remove();//清除标点}

最后还差一个标点的点击，那就重新写一个initView,把相关的findById都写到这里面吧。

 private void initView() {// 地图初始化mMapView = (MapView) findViewById(R.id.bmapView);//回到当前定位ibLocation = (ImageButton) findViewById(R.id.ib_location);mMapView.showScaleControl(false);  // 设置比例尺是否可见（true 可见/false不可见）//mMapView.showZoomControls(false);  // 设置缩放控件是否可见（true 可见/false不可见）mMapView.removeViewAt(1);// 删除百度地图LogomBaiduMap = mMapView.getMap();mBaiduMap.setOnMarkerClickListener(new BaiduMap.OnMarkerClickListener() {@Overridepublic boolean onMarkerClick(Marker marker) {final String info = (String) marker.getExtraInfo().get("info");Toast.makeText(MainActivity.this, info, Toast.LENGTH_SHORT).show();return true;}});}

然后你再看这个onCreate方法。

只要调用就可以了。运行效果如下：

五、权限问题

如果你运行源码之后发现定位到的地方并不是当前的位置，甚至偏了十万八千里，那么你就要检查一下是不是鉴权信息错误了，这其实是你当前相关的开发版SHA1和当前平台上的不一致造成了，比如我现在在家里的电脑克隆源码下来，然后运行在自己的手机上，发现定位在海里，等我放大之后发现在几内亚湾，都到了非洲的海域了。

你可以看一下你运行时你的Run里面有没有如下这样的异常信息。

如果有的话，那么现在就来解决一下。首先重新获取一下当前的开发版SHA1，如果你不记得了，往上滑动再看看就好。

然后你再看看平台上的开发版SHA1

你都不用全部看完，只要有一个鉴权失败，铁定就不行，那么只要改变一下平台上的开发版SHA1就可以了，复制刚才控制台中的SHA1，然后粘贴到平台的这个输入框中，然后点击提交，之前你再运行刚才的项目。

然后你会发现，还是在几内亚湾，不过你看Run中的报错已经没有了，不过还有一个错误，我之前写这个文章的时候这个地图的SDK还不需要我写数据，所以我就没有动态请求权限，而现在又要了，很明显是百度的人动了手脚。

① 动态权限请求

那么下面就来动态请求一下定位和写入文件的权限，这里我们使用Android原生的方式，在MainActivity中添加这样的代码：

 //需要请求的动态权限private final String[] permissionArray = new String[]{Manifest.permission.ACCESS_COARSE_LOCATION,Manifest.permission.ACCESS_FINE_LOCATION,Manifest.permission.READ_PHONE_STATE,Manifest.permission.WRITE_EXTERNAL_STORAGE};//动态请求权限private ActivityResultLauncher<String[]> requestPermissions;

位置如下图所示：

然后初始化这个requestPermissions，代码如下所示：

 requestPermissions = registerForActivityResult(new ActivityResultContracts.RequestMultiplePermissions(), result -> {boolean coarseLocation = Boolean.TRUE.equals(result.get(Manifest.permission.ACCESS_COARSE_LOCATION));boolean fineLocation = Boolean.TRUE.equals(result.get(Manifest.permission.ACCESS_FINE_LOCATION));boolean readPhoneState = Boolean.TRUE.equals(result.get(Manifest.permission.READ_PHONE_STATE));boolean writeStorage = Boolean.TRUE.equals(result.get(Manifest.permission.WRITE_EXTERNAL_STORAGE));if (coarseLocation && fineLocation && readPhoneState && writeStorage) {//所有权限都已经成功获取initLocation();// 定位初始化} else {Toast.makeText(MainActivity.this, "有权限未通过", Toast.LENGTH_SHORT).show();}});

此代码添加位置如下图所示：

然后我们写一个方法用来检查权限。

 /*** 检查版本*/private void checkVersion() {//Android6.0以下不需要动态请求权限，直接初始化if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {initLocation();// 定位初始化return;}//Android6.0及以上需要动态请求权限，所以需要检查是否已经请求了权限。boolean result = false;//遍历权限数组，有一个没有通过则表示需要请求权限，这里还能再细分每一个请求权限。for (String permission : permissionArray) {result = checkSelfPermission(permission) == PackageManager.PERMISSION_GRANTED;}if (result) initLocation();else requestPermissions.launch(permissionArray);}

然后我们在onCreate中调用此方法。

最后在AndroidManifest.xml中增加一个静态权限。

 <!--读取手机状态--><uses-permission android:name="android.permission.READ_PHONE_STATE"/>

然后运行，发现就可以了，终于不是在几内亚湾了。

六、源码

做一个Demo，自然要把源码放上去，先看效果图，合适再运行源码，OK，最后不理解代码再来看博客的讲述，你就知道是怎么回事了，至于自己写的原因是在于官方的文档我觉得并不详细，而我可以把每一步写进来，这才是我写作的初衷。时隔两年将这个文章和代码重新更新了一下

GitHub：MapDemo

如果对你有所帮助的话，不妨Stat或者Fork一下。