Android 高德地图API(详细步骤+源码)一 | 您所在的位置:网站首页 › android高德定位图标有时候大有时候小怎么办 › Android 高德地图API(详细步骤+源码)一 |
高德地图API使用详解前言正文一、创建应用① 获取PackageName② 获取调试版安全码SHA1③ 获取发布版安全码SHA1二、配置Android Studio工程① 导入SDK② 配置AndroidManifest.xml三、获取当前定位信息① 版本判断② 动态权限请求③ 初始化定位④ 获取定位结果四、显示地图五、显示当前定位地图六、地图设置① 修改自定义定位图标② 设置缩放等级③ 开启室内地图④ 地图控件设置七、获取POI数据八、源码尾声前言 为了丰富对地图、定位的了解,在写了百度、腾讯的地图定位之后,终于到了高德地图了。我个人平时日常使用最多的定位软件就是高德地图。所以这篇文章,就带你来初步了解使用。 正文在此之前呢,默认都没有账号,因此需要先注册一个账号账号才行,点击高德开放平台进入主页面。 ![]() 点击右上角的注册按钮,然后选择注册开发者的类型,有个人开发者、企业开发者。 ![]() 如果你已经工作了可以选择企业开发者,只不过需要填写的资料要多一些,这里我选择成为个人开发者,点击。 ![]() 勾选上这个选项,然后点击确认注册开发者,进入下一步,填写个人资料。 ![]() 填写个人资料,实名认证,请注意实名认证,一个身份只能认证一个开发者账号,后面个人主页和开发者简介属于选填的。 ![]() 点击下一步就注册完成了。然后重新进入高德开放平台登录你刚才注册的账号,之后进入控制台选择应用管理,进入我的应用。 一、创建应用![]() 然后点击创建新应用按钮 ![]() 填写应用信息,然后点击新建。 ![]() 建好应用之后需要添加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。 ![]() 然后你会看到Run下会出现如下图类似的信息。 ![]() 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就生成好了。 ![]() 首先要下载SDK,点击SDK下载 ![]() 如上图配置,然后点击下载,下载到本地后解压,解压之后如下所示: ![]() 复制这些文件到你的libs下。然后点击这个小象图标进行工程的资源配置同步。 ![]() 最终如下图所示,你可以看到你的这个jar现在是可以打开的。 ![]() 然后打开你的app下的build.gradle文件,在android闭包下添加 sourceSets { main{ jniLibs.srcDirs = ['libs'] } }![]() 然后点击Sync进行再一次同步。下面进行AndroidManifest.xml的配置 ② 配置AndroidManifest.xml打开AndroidManifest.xml,首先在application标签下添加定位服务 然后添加在manifest标签下添加如下权限。 最后在application标签下添加高德的访问key 这个值和你创建的key的值一致,如下图所示则是我的key。 ![]() 下面设想一个情景,我想要一打开应用就获取到当前定位信息。 那么基于这个目的下面来写代码。刚才在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闭包下添加如下依赖: //Google推荐的EasyPermission库 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() { //初始化定位 mLocationClient = new AMapLocationClient(getApplicationContext()); //设置定位回调监听 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。 然后回到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(); }下一篇Android 高德地图API(详细步骤+源码)二 |
CopyRight 2018-2019 实验室设备网 版权所有 |