通过上一篇文章的介绍,基本了解百度地图的基本信息,接下来就让我们一起来实际在项目中操作,显示出地图。
01 引入地图SDK
首先需要新建一个空白的Android项目,如下所示(具体新建项目这里不进行阐述)。
新建的项目
接着在百度地图的官方网站下载,应用程序需要的地图SDK。其中需要注意,框选自己应用需要的业务即可。下载界面如下图所示:
下载SDK
点击左侧产品下载就可进入自定义下载界面,目前官网已更新到最新集成模式,如下图所示。
自定义百度地图SDK
建议下载:定位SDK下载全量定位,地图SDK则如何应用中不进行步骑行导航则就按照默认选择【基础地图】【检索】就OK,在配置模块,开发包格式,记得选择JAR,AAR是谷歌最新的格式文件,目前还用不上。按照默认选择即可。
点击底部的开发包,就成功下载百度地图SDK开发包,这些包后期需成功引用到Android应用中,否则软件无法加载并使用百度地图服务。
也可下载示例代码,里面是官方给的代码Demo,可进行参考。
下载后的文件见下图,后面需要将其全部引入到应用程序中。
sdk目录
这里分两步
- 将解压后的文件全部复制到Android项目的libs目录中。
在app目录下的build.gradle文件中android块中配置sourceSets标签,如果没有使用该标签则新增,详细配置代码如下:
sourceSets { main { jniLibs.srcDir 'libs' } }
- 在项目中引入libs目录下的百度地图jar包。
引入JAR包
编译没有问题后,则证明引入百度地图SDK成功。
02 百度地图常规配置
1、还记得上一期利用keytool生成的密钥吗?下来进行密钥的配置。其实也比较简单,在AndroidManifest.xml文件中新加开发者key值,如下图所示:
点击标红框的中复制图标,复制访问应用密钥AK,将其按照百度的文档要求,填写到AndroidManifest.xml文件中。
<application> <meta-data android:name="com.baidu.lbsapi.API_KEY" android:value="开发者 key" /> </application>
在“开发者value”中填写应用密钥AK,即可完成密钥的配置。
要求格式
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.zyc.testandroid"> <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:roundIcon="@mipmap/ic_launcher_round" android:supportsRtl="true" android:theme="@style/AppTheme"> <!--申请密钥百度生成的key值--> <meta-data android:name="com.baidu.lbsapi.API_KEY" android:value="1NNsn6oRNdM*******MtEMvPNcARRL5" /> <activity android:name=".MainActivity"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> </manifest>
2、申请百度地图需要的权限
由于目前android版本最新到10,而且从8.0之后,申请手机内部都必须询问,征得客户同意才可以进行各种权限的获取。
当版本过低时,在AndroidManifest.xml文件中,加入下面权限信息,就可进行权限的访问。当版本比较高时,也就是手机比较新让我看看吗?
低版本 默认许可
百度地图许可 <!-- 访问网络,进行地图相关业务数据请求,包括地图数据,路线规划,POI检索等 --> <uses-permission android:name="android.permission.INTERNET" /> <!-- 获取网络状态,根据网络状态切换进行数据请求网络转换 --> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- 读取外置存储。如果开发者使用了so动态加载功能并且把so文件放在了外置存储区域,则需要申请该权限,否则不需要 --> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <!-- 写外置存储。如果开发者使用了离线地图,并且数据写在外置存储区域,则需要申请该权限 --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 百度定位许可 <!-- 这个权限用于进行网络定位--> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission> <!-- 这个权限用于访问GPS定位--> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission> <!-- 用于访问wifi网络信息,wifi信息会用于进行网络定位--> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission> <!-- 获取运营商信息,用于支持提供运营商信息相关的接口--> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission> <!-- 这个权限用于获取wifi的获取权限,wifi信息会用来进行网络定位--> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission> <!-- 写入扩展存储,向扩展卡写入数据,用于写入离线定位数据--> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission> <!-- 访问网络,网络定位需要上网--> <uses-permission android:name="android.permission.INTERNET"></uses-permission>
高版本 动态申请
// 权限请求 private void getPermissionMethod() { List<String> permissionList = new ArrayList<>(); if(ContextCompat.checkSelfPermission(MainActivity.this,Manifest.permission.ACCESS_FINE_LOCATION)!= PackageManager.PERMISSION_GRANTED){ permissionList.add(Manifest.permission.ACCESS_FINE_LOCATION); } Log.i(TAG, "getPermissionMethod: permissionListSize:"+permissionList.size()); if (!permissionList.isEmpty()){ //权限列表不是空 String[] permissions = permissionList.toArray(new String[permissionList.size()]); ActivityCompat.requestPermissions(MainActivity.this,permissions,1); }else{ Log.i(TAG, "getPermissionMethod: requestLocation !permissionList.isEmpty()里"); requestLocation(); } }
执行程序,如果没有报错,那么证明目前的引入SDK,配置相关环境成功。
你真棒,有眼光。