Android 高德地图 API（向上）
前言
为了丰富对地图、定位的了解，在写了百度、腾讯的地图定位之后，终于到了高德地图了。我个人平时日常使用最多的定位软件就是高德地图。所以这篇文章，就带你来初步了解使用。
正文
在此之前呢，默认都没有账号，因此需要先注册一个账号账号才行，点击高德开放平台进入主页面。
点击右上角的注册按钮，然后选择注册开发者的类型，有个人开发者、企业开发者。
如果你已经工作了可以选择企业开发者，只不过需要填写的资料要多一些，这里我选择成为个人开发者，点击。
勾选上这个选项，然后点击确认注册开发者，进入下一步，填写个人资料。
填写个人资料，实名认证，请注意实名认证，一个身份只能认证一个开发者账号，后面个人主页和开发者简介属于选填的。
点击下一步就注册完成了。然后重新进入高德开放平台登录你刚才注册的账号，之后进入控制台选择应用管理，进入我的应用。
一、创建应用
然后点击创建新应用按钮
填写应用信息，然后点击新建。
建好应用之后需要添加key，点击添加。
添加key需要你的应用的一些信息，你可以和我的这个图一样。
从上面的图来看还需要三个值，发布版安全码SHA1、调试版安全码SHA1、PackageName。
① 发布版安全码SHA1就是你的应用发布正式版本时的安全码，常规是使用jks秘钥来生成release包。 ② 调试版安全码SHA1就是你的应用通过usb直接运行在手机或者虚拟机时的安全码，同一个项目在不同的电脑上运行，这个安全码各不相同。 ③ PackageName 就是你的应用包名。
① 获取PackageName
下面我将在一一获取这三个值，保留当前的网页，然后打开你的Android Studio，新建一个名为GaodeMapDemo的项目，如下图所示
注意这个包名，现在你就可以复制这个包名到刚才的网页中的输入框中，位置如下图所示，key的包名需要和你的应用包名保持一致。
然后回到AS，点击Finish完成你的项目的创建。
② 获取调试版安全码SHA1
下面来获取调试版安全码SHA1
创建好项目之后，注意你的AS的右侧边栏，点击Gradle → app → android → signingReport，最后双击signingReport。
当你的AS版本为4.2.1时，你会发现这里好像有点不一样了，找不到signingReport了，这是AS更新之后默认这个功能关掉了，需要去手动打开它。在设置里面
如下图这里默认勾选上了，现在把这根勾选上的去掉。
然后Sync，或者点击这个小图标。
然后你的项目的右侧边栏就会出现这个熟悉的task了。
然后你会看到Run下会出现如下图类似的信息。
而当你的Android Studio是Android Studio Dolphin | 2021.3.1以及以上版本时，你就需要使用下面这种方式来获取开发版SHA1。你需要先在环境变量中配置Java JDK版本，然后再使用指令，配置JDK的话就用11或以上版本就可以了，JDK的安装配置就不用我再多说了吧。下面进行调试版SHA1的获取，Win + R ，输入cmd，进入命令窗口。
输入
cd .android
回车
先切换到.android目录下，然后输入
keytool -list -v -keystore debug.keystore
回车之后会让你输入密钥，默认的密钥就是android，你输入的时候是不可见的，光标也不会有反应，你只管输入就行，输入完回车就能看到SHA1了，如下图所示。
debug就是调试版，那么它的SHA1就是调试版安全码SHA1，这正是我所需要的。下面将它复制到刚才的网页中，如下图所示，别放错位置了。
最后来获取发布版安全码SHA1。
③ 获取发布版安全码SHA1
这个稍微有一些麻烦，因此需要先创建一个jks文件才行。
点击Build 选择点击Generate Signed Bundle / APK...
选择APK，然后Next。
然后是配置，这里需要填写jks的路径，但是我没有这个jks，因此点击Create new...按钮去创建一个。
首先要指定这个jks的文件存放路径和文件名。
这里我存放在D盘下的APK文件夹中，然后设置jks的名字为GaodeMapDemo，然后点击OK。
输入jks的密码和key的密码，最后点击OK。
会弹出这样一个窗口，不用管它，点击OK。（新版本没有这个弹窗了）
勾选记住密码，然后点击Next。
选择release，然后两个都勾选上，最后点击Finish。
当你看到AS的右下角出现这一提示时，就说明你的release包已经生成好了。
在你的AS中查看这个apk，你可以复制它通过电脑QQ发给你的手机，然后在手机上直接打开安装。
然后你就能看到熟悉的Hello World！接下来进入Android Studio的Terminal工具输入如下图所示的命令和jks存放路径。
//如果你前面的步骤和我一模一样的话，这里你就可以复制粘贴，不一样的话就修改jks的路径就可以了
keytool -list -v -keystore D:\APK\GaodeMapDemo.jks
输入密码，输入时不可见。输入完直接回车，然后你会看到如下图类似的信息。
复制到网页中，位置如下图所示，点击提交。
这个key就生成好了。
二、配置Android Studio工程
这里我们需要用到高德的SDK，点击 开发支持 → Android 地图SDK。
点击相关下载，找到合包下载，选择3D地图合包。
里面包含了3D地图SDK、搜索SDK、定位SDK，相对来说比较的全面，点击下载。下载到本地后解压，解压之后如下所示：
① 导入SDK
复制这些文件到你的工程的libs下，如果没有找到libs目录，就将项目结构从Android切换到Project就能找到了，放进去之后检查一下你的app的build.gradle中的dependencies{}闭包下有没有这样一样代码：
implementation fileTree(dir: 'libs', include: ['*.jar'])
在之前的老版本Android Studio中这句话是默认有的，但是出于不是所有项目都需要这一行代码，就在后续版本中去掉了，而我们导入sdk就需要这样一行代码，现在将它添加到dependencies{}闭包下，如图所示。
然后你可以Sync Now或者点击这个小象图标进行工程的资源配置同步。
同步完成之后，你可以看到你的这个jar现在是可以打开的。
不过有一部分人这样做了之后，jar包没有发生任何变化，那么你可以采取另一种方式，鼠标右键点击这个jar包，然后选择Add as Library...，之后会出现一个弹窗，默认是添加到你当前的app模块，你点击OK即可。然后等待同步，你就会发现你的jar包展开了。
然后打开你的app下的build.gradle文件，在android闭包下添加。
sourceSets {
main{
jniLibs.srcDirs = ['libs']
}
}
然后点击Sync进行再一次同步，下面进行AndroidManifest.xml的配置。
② 配置AndroidManifest.xml
打开AndroidManifest.xml，首先在application标签下添加定位服务
<!--定位service-->
<service android:name="com.amap.api.location.APSService"/>
然后添加在manifest标签下添加如下权限。
<!--用于访问网络，网络定位需要上网-->
<uses-permission android:name="android.permission.INTERNET" />
<!--用于读取手机当前的状态-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!--用于写入缓存数据到扩展存储卡-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!--用于申请调用A-GPS模块-->
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
<!--用于进行网络定位-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!--用于访问GPS定位-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!--用于获取运营商信息，用于支持提供运营商信息相关的接口-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!--用于访问wifi网络信息，wifi信息会用于进行网络定位-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!--用于获取wifi的获取权限，wifi信息会用来进行网络定位-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
最后在application标签下添加高德的访问key
<!--设置高德Key-->
<meta-data android:name="com.amap.api.v2.apikey" android:value="d3347ee0f2928f9a0c199cae009ae7f7"/>
这个值和你创建的key的值一致，如下图所示则是我的key，你要使用自己的Key。
③ 隐私政策设置
随着工信部推行加强个人信息隐私的保护政策，各大SDK都需要相应增加一个API接口，确保用户是在知道会采集信息的情况下使用某一个功能，所以我们在使用高德的定位、地图、搜索功能时，需要先同意隐私政策，不通过则无法使用，一般是通过App启动之后出现一个弹窗，弹窗中你告知用户那些信息被采集，用到了那些SDK，作用是什么。并且要有隐私政策的链接地址，很麻烦。这里我们就简单一些，在com.llw.mapdemo包下新建一个MapApplication类，里面的代码如下：
public class MapApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
Context context = this;
//定位隐私政策同意
AMapLocationClient.updatePrivacyShow(context,true,true);
AMapLocationClient.updatePrivacyAgree(context,true);
//地图隐私政策同意
MapsInitializer.updatePrivacyShow(context,true,true);
MapsInitializer.updatePrivacyAgree(context,true);
//搜索隐私政策同意
ServiceSettings.updatePrivacyShow(context,true,true);
ServiceSettings.updatePrivacyAgree(context,true);
}
}
我们在项目初始化的时候就通过这些隐私政策，这不是最终的做法，如果你上架应用的时候这么做就会被驳回。为了使这个MapApplication生效，我们需要在AndroidManifest.xml中配置它。比较简单，如下图所示。
下面我们可以去写代码了。
三、获取当前定位信息
现在设想一个情景，我想要一打开应用就获取到当前定位信息。那么基于这个目的下面来写代码。刚才在AndroidManifest.xml配置了比较多的权限，而在实际的使用过程中，Android6.0之后有一些权限是需要用户动态申请的，比如定位、获取手机状态、文件读写之类的。
因此首先得先判断当前是否需要动态请求权限，所以要根据Android的版本来判断。
① 版本判断
于是就可以在MainActivity中写入这样一个checkingAndroidVersion()方法。
/**
* 检查Android版本
*/
private void checkingAndroidVersion() {
if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.M){
//Android6.0及以上先获取权限再定位
}else {
//Android6.0以下直接定位
}
}
用于检查Android版本。6.0以下则直接定位，6.0及以上则动态申请权限，然后在权限通过的返回中进行定位，思路很清晰了，下面你要在onCreate中调用这个 checkingAndroidVersion() 方法。
下面来写这个动态权限的请求，这个其实也没有必要用原生的权限请求，网络上有很多优秀的框架可以帮助你快速实现，比如这个EasyPermission，在之前我是没有讲述过这个权限请求框架的。下面来看看。
② 动态权限请求
打开app下的build.gradle，在dependencies闭包下添加如下依赖：
implementation 'pub.devrel:easypermissions:3.0.0'
如下图所示
然后点击AS右上角的Sync进行同步，同步完成之后，你就可以使用了。回到MainActivity中， 先增加一个成员变量
//请求权限码
private static final int REQUEST_PERMISSIONS = 9527;
新增requestPermission()方法。
/**
* 动态请求权限
*/
@AfterPermissionGranted(REQUEST_PERMISSIONS)
private void requestPermission() {
String[] permissions = {
Manifest.permission.ACCESS_COARSE_LOCATION,
Manifest.permission.ACCESS_FINE_LOCATION,
Manifest.permission.READ_PHONE_STATE,
Manifest.permission.WRITE_EXTERNAL_STORAGE
};
if (EasyPermissions.hasPermissions(this, permissions)) {
//true 有权限 开始定位
showMsg("已获得权限，可以定位啦！");
} else {
//false 无权限
EasyPermissions.requestPermissions(this, "需要权限", REQUEST_PERMISSIONS, permissions);
}
}
这个方法中对权限进行了判断，有权限则可以定位，没有权限则请求权限
/**
* 请求权限结果
* @param requestCode
* @param permissions
* @param grantResults
*/
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
//设置权限请求结果
EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this);
}
通过重写onRequestPermissionsResult方法来获取权限授予的返回结果，然后再通过EasyPermissions.onRequestPermissionsResult设置，设置之后会重新调用requestPermission()方法，为什么呢？就因为这个注解**@AfterPermissionGranted(REQUEST_PERMISSIONS)**，然后又会判断是否有权限，有则进行之后的定位，下面可以来写定位的方法了。
简单写一个消息提示的方法，用于当前Activity的使用。
/**
* Toast提示
* @param msg 提示内容
*/
private void showMsg(String msg){
Toast.makeText(this,msg,Toast.LENGTH_SHORT).show();
}
下面进行定位的初始化
③ 初始化定位
首先在MainActivity中新增两个成员变量
//声明AMapLocationClient类对象
public AMapLocationClient mLocationClient = null;
//声明AMapLocationClientOption对象
public AMapLocationClientOption mLocationOption = null;
然后新增一个initLocation()方法。
/**
* 初始化定位
*/
private void initLocation() {
//初始化定位
try {
mLocationClient = new AMapLocationClient(getApplicationContext());
} catch (Exception e) {
e.printStackTrace();
}
if (mLocationClient != null) {
//设置定位回调监听
mLocationClient.setLocationListener(this);
//初始化AMapLocationClientOption对象
mLocationOption = new AMapLocationClientOption();
//设置定位模式为AMapLocationMode.Hight_Accuracy，高精度模式。
mLocationOption.setLocationMode(AMapLocationClientOption.AMapLocationMode.Hight_Accuracy);
//获取最近3s内精度最高的一次定位结果：
//设置setOnceLocationLatest(boolean b)接口为true，启动定位时SDK会返回最近3s内精度最高的一次定位结果。如果设置其为true，setOnceLocation(boolean b)接口也会被设置为true，反之不会，默认为false。
mLocationOption.setOnceLocationLatest(true);
//设置是否返回地址信息（默认返回地址信息）
mLocationOption.setNeedAddress(true);
//设置定位请求超时时间，单位是毫秒，默认30000毫秒，建议超时时间不要低于8000毫秒。
mLocationOption.setHttpTimeOut(20000);
//关闭缓存机制，高精度定位会产生缓存。
mLocationOption.setLocationCacheEnable(false);
//给定位客户端对象设置定位参数
mLocationClient.setLocationOption(mLocationOption);
}
}
这里的代码相比之前的版本中，增加了捕获异常信息和调用之前先判空，这是官方需要这么做的，然后在onCreate方法中进行调用。
注意initLocation()的调用在checkingAndroidVersion()之前，你可能会问为什么，那是因为你想定位，那么首先要先配置一些参数，配置好之后才能启动定位，否则会报错，常见的就是空指针异常。而检查版本之后当有权限时，就直接定位了，而把这个方法放到checkingAndroidVersion()里面去并不是很明智，因为你可能要调用两次，这样明显浪费资源，因此这就是为什么它要在checkingAndroidVersion()方法之前调用的原因。你想不到有这么多门道吧。
至于initLocation()方法本身我也没有什么好解释的，因为注释已经写的非常明白了，下面还有比较的最后一步，那就是定位的发起和定位结果的获取了。
④ 获取定位结果
首先要发起定位才能获取定位结果。 那么可以这样写。首先要在Android6.0以下直接启动定位。这次定位配置已经完毕，所以你完全不用担心会报错。
其次在权限允许之后进行定位。
现在定位已经发起了，那么定位结果怎么获取呢？不知道你有没有注意到我在initLocation()方法中的这行代码。
mLocationClient.setLocationListener(this);
注意到这里传入的是this，则表明通过当前Activity来实现定位结果的监听，那么可以通过实现AMapLocationListener，重写里面的onLocationChanged方法来获取定位结果。
onLocationChanged方法如下：
/**
* 接收异步返回的定位结果
*
* @param aMapLocation
*/
@Override
public void onLocationChanged(AMapLocation aMapLocation) {
if (aMapLocation != null) {
if (aMapLocation.getErrorCode() == 0) {
//地址
String address = aMapLocation.getAddress();
} else {
//定位失败时，可通过ErrCode（错误码）信息来确定失败的原因，errInfo是错误信息，详见错误码表。
Log.e("AmapError", "location Error, ErrCode:"
+ aMapLocation.getErrorCode() + ", errInfo:"
+ aMapLocation.getErrorInfo());
}
}
}
现在已经拿到了定位的结果了，为了更直观，所以需要显示在当前的Activity中，那么下面修改布局activity_main.xml。
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns: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"
android:gravity="center"
tools:context=".MainActivity">
<TextView
android:id="@+id/tv_content"
android:padding="20dp"
android:textSize="18sp"
android:textColor="#000"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello World!" />
</LinearLayout>
然后回到MainActivity，新增加一个成员变量。
//内容
private TextView tvContent;
然后在onCreate中，绑定控件id。它在initLocation()方法之前
tvContent = findViewById(R.id.tv_content);
然后在onLocationChanged中显示
这个我解释一下这个用法
address == null ? "无地址" : address
这个是三目运算，address == null 表示这个条件是否成立，如果成立则返回 "无地址"，不成立则返回 address，它的意思和下面这个if else一样。
if(address == null){
tvContent.setText("无地址");
}else {
tvContent.setText(address);
}
熟练了你就知道怎么使用了。它会比你使用if else 来更简洁，不是吗？
OK，写了这么多代码也该要运行一下了吧。
可以看到第一次打开时提醒你需要权限，然后进行授权，授权后获得定位显示定位数据，之前我关闭当前应用，再一次进入，此时已经有了权限，则直接进行定位，然后显示定位数据。如果要显示经纬度的话还可以再修改一下。
StringBuffer stringBuffer = new StringBuffer();
stringBuffer.append("纬度：" + latitude + "\n");
stringBuffer.append("经度：" + longitude + "\n");
stringBuffer.append("地址：" + address + "\n");
tvContent.setText(stringBuffer.toString());
再运行一下：
当然，获取定位数据的信息还不止这些，还有如下这些，感兴趣可以自行去尝试。
aMapLocation.getLocationType();//获取当前定位结果来源，如网络定位结果，详见定位类型表
aMapLocation.getAccuracy();//获取精度信息
aMapLocation.getCountry();//国家信息
aMapLocation.getProvince();//省信息
aMapLocation.getCity();//城市信息
aMapLocation.getDistrict();//城区信息
aMapLocation.getStreet();//街道信息
aMapLocation.getStreetNum();//街道门牌号信息
aMapLocation.getCityCode();//城市编码
aMapLocation.getAdCode();//地区编码
aMapLocation.getAoiName();//获取当前定位点的AOI信息
aMapLocation.getBuildingId();//获取当前室内定位的建筑物Id
aMapLocation.getFloor();//获取当前室内定位的楼层
aMapLocation.getGpsAccuracyStatus();//获取GPS的当前状态
还可以在获取信息之后，将定位给停止
//停止定位后，本地定位服务并不会被销毁
mLocationClient.stopLocation();
在页面销毁时同时销毁本地定位服务。
@Override
protected void onDestroy() {
super.onDestroy();
//销毁定位客户端，同时销毁本地定位服务。
mLocationClient.onDestroy();
}
未完待续。。。