1. 官网下载SDK
建议下载sdk.demo示例。示例文件libs文件夹下包含.so文件和.jar文件。
2. 打开AS project,导入百度地图SDK,两种方法
方法一(推荐):在app.libs文件夹下将.jar文件导入,app.src.main文件夹下创建jniLibs文件夹并导入.so文件(图一)。
图一
图二
方法二:.jar文件必须导入到app.libs文件夹下,而.so文件可以存放在其他文件夹下(比如与.jar文件同导入app.libs,图二),此时必须在build.gradle(app)文件android{}中加入 sourceSets{ main{ jniLibs.srcDirs = ['libs'] } },以关联app.libs文件夹下的.so文件(图三),其中‘libs’可以换成其他路径。
图三
Tips:注意了,如果使用了方法一,而且又加入了方法二的代码,编译不报错,但程序会闪退,原因就是找不到.so文件(本人就是吃过这个亏)
3. 添加.jar文件依赖,也有两种方法
方法一(推荐):直接在build.gradle(app)文件中加入依赖:
dependencies {
implementation files('libs/BaiduLBS_Android.jar')
//创建baidumap的Jar包依赖
}
方法二:通过菜单File——>Project Structure——>左边Modules.app——>右边Dependencies——>右侧绿色的加号,导入所需要的.jar文件即可,build.gradle中会自动导入方法一的代码。
(这个方法笔者不管用,不知道是什么原因,加入后还是没反应)
4. 获取密钥并加入到配置文件
1)获取密钥,没有百度账号则需要先注册。
这里需要知道发布SHA1数字证书,Android studio在安装的时候会自动生成一个测试用的Debug数字证书,存储在用户下.android文件夹的debug.keystore文件中,每台计算机都不一样(只能供测试使用)。该测试证书可以通过windows终端或者AS自带的terminal中,进入C:\Users\用户名\.android\文件夹下,使用keytool -list -v -keystore debug.keystore命令:
找到SHA1证书码,输入到图六中SHA1栏中,同时包名栏填写你新建的这个project的包名即可。确认后就可得到密钥(AK):
2)加入密钥到配置文件中,在AndroidManifest.xml配置文件中的<application>标签中添加子标签<meta-data>,加入刚刚获取的密钥:
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="15EBOMkdDyvu8GFlLmrrZLnkOT5kGBdf" />
<!-- 加入密钥 -->
以下5—8步骤均可以参考百度官方网站hello baidumap案例:
5. 添加API所需要的权限
百度地图API需要以下权限
打开AndroidManifest.xml配置文件,在<application>标签之外,添加需要的地图权限:
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<!--//获取设备网络状态,禁用后无法获取网络状态-->
<uses-permission android:name="android.permission.INTERNET"/>
<!--//网络权限,当禁用后,无法进行检索等相关业务-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!--//读取设备硬件信息,统计数据-->
<uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />
<!--//读取系统信息,包含系统版本等信息,用作统计-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!--//获取设备的网络状态,鉴权所需网络代理-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!--//允许sd卡写权限,需写入地图数据,禁用后无法显示地图-->
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<!--//获取统计数据-->
<uses-permission android:name="android.permission.GET_TASKS" />
<!--//鉴权所需该权限获取进程列表-->
<uses-permission android:name="android.permission.CAMERA" />
<!--//使用步行AR导航,配置Camera权限-->
6. 布局文件中添加百度地图组件
打开布局文件activity_main.xml添加地图组件:
<com.baidu.mapapi.map.MapView
android:id="@+id/mmapview"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:clickable="true">
</com.baidu.mapapi.map.MapView>
Tips:注意了,这里不能在预览页面直接加入MapView组件,这是因为Design页面只能加入google地图组件,必须手动添加百度地图组件的代码。(否则的话,我的情况是,在build.Module页面会出现,依赖了不同版本的libraries错误,不知道你们会是什么错误)
7. 初始化context,以及获取百度地图组件的对象
在MainActivity.java文件的onCreate()方法中加入(需要在setContentView()方法之前执行)SDKInitializer.initialize(getApplicationContext())语句,来初始化地图SDK;并获取地图控件对象mMapView:
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
SDKInitializer.initialize(getApplicationContext());
setContentView(R.layout.activity_main);
mMapView = findViewById(R.id.mmapview);
}
Tips:注意了,使用百度地图组件前,必须执行SDKnitializer.initialize()进行初始化,否则程序会闪退。
8. 重写activity生命周期的方法,管理地图周期
@Override
protected void onResume() {
super.onResume();
mMapView.onResume();
}
@Override
protected void onPause() {
super.onPause();
mMapView.onPause();
}
@Override
protected void onDestroy() {
mMapView.onDestroy();
mMapView = null;
super.onDestroy();
}
@Override
protected void onStop() {
super.onStop();
if (mLocationClient.isStarted())
mLocationClient.stop();
}
至此,以上导入百度地图SDK(包含定位SDK)基本完成,需要进行地图定位的请参考官方文档:
//地图SDK(显示定位样式)
//定位SDK(即时获取定位数据)
使用定位sdk时还需添加一下额外配置:
1.在AndroidManifest.xml中的application标签中加入service组件:
<service
android:name="com.baidu.location.f"
android:enabled="true"
android:process=":remote">
</service>
2.添加定位SDK的额外权限:
<!-- 这个权限用于进行网络定位-->
<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.READ_PHONE_STATE"/>
<!-- 写入扩展存储,向扩展卡写入数据,用于写入离线定位数据-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!-- 访问网络,网络定位需要上网-->
<uses-permission android:name="android.permission.INTERNET" />
<!-- SD卡读取权限,用户写入离线定位数据-->
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
Tips:注意了,显示定位代码中需要加入第一次定位动态移动到定位点的代码(官网没有给出),不然地图不会自动跳转到当前定位点,代码如下:(mBaiduMap为BaiduMap对象)
if (ifFrist) {
LatLng ll = new LatLng(bdLocation.getLatitude(),
bdLocation.getLongitude());
//获取当前经纬度对象
MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(ll);
mBaiduMap.animateMapStatus(update,2000);
// 移动到某经纬度(中心点) 耗时2秒
update = MapStatusUpdateFactory.zoomTo(17);
mBaiduMap.animateMapStatus(update);
// 放大层级(4至21)f
ifFrist = false;
}
总结:完成以上各个配置,就可以开始进行MainActivity.java代码的编写,这里给大家解释一下百度地图SDK与定位SDK分工:百度地图SDK主要控制的就是定位样式、定位图标等显示样式(外在的),而百度定位SDK则是提供定位数据以及定位监听事件的动态配置等(内在的),两者结合形成定位系统!
详细java代码请参考(https://www.jianshu.com/p/7cf34278d279)
感谢这位大神,代码简练易懂~