Android使用第三方SDK——百度地图
第一次用百度地图是在去年的8月中旬吧,当时是参加一个比赛,老师要求使用地图,然后就是百度,各种视频网站一顿搜啊(当时Android还没入门,就知道CV),最终效果实现了,但是到底是怎么实现的还是不太懂(当时用的是百度的),后来是因为百度的获取路径规划有点儿困难(毕竟还没入门,当时接触Android才一个月左右),后来换高德了,最终实现了,从开始知道百度地图,到现在已经用了好几次了,但大都是帮别人的,前几天在群里又发现有人问了,然后我自己写了一个可以实现地图+定位的给他,从开始创建项目,到功能实现没有10分钟,然后就想把这篇文章写出来了。哈哈,开车,开车~
- 注册百度开发者账号+下载相关的SDK
相信大家都有百度网盘,然后登陆就用网盘账号就好啦~
接下来就是去下载相关的SDK包了,这里给出链接,当然大家可以去官网哈!
百度地图SDK相关下载
然后大家就会看到如下界面:
我们选择我们需要的功能进行下载,这里只演示:地图+定位,所以就只下载基础定位+基础地图选中后,点击开发包下载就好了,然后把压缩包解压,如下:
- 将下载的jar和so文件集成到项目中
将jar文件copy到——ApplicationName/app/libs目录下如下:
在该jar右键点击Add As Library如下图所示:
将百度地图的jar添加到项目的闭包中。
添加so文件:
在ApplicationName/app/src/main目录下新建jniLibs文件夹,并将所有的so文件都copy到该目录下,完成后如下:
将jniLibs添加到本地仓库中
打开ApplicationName/app/build.gradle并添加如下内容:
//添加本地仓库
repositories {
flatDir {
dirs 'libs'
}
}
注意位置哈,最后的完成效果应该这样的,如下:
也就是说,添加本地仓库代码并不是在android中的,而是属于单独的一个。
- 添加地图控件、添加开发者key、清单文件中申请权限、添加定位服务
既然添加key,那么必须要有key,我们先来申请key吧,先看下申请key的界面如下:
可以看到有两个挂*号,那么意思就是要必须填咯,包名简单,在清单文件中就有,相信大家都能找到的,那么SHA1在哪儿呢,简单的我们可以这样获取,如下图:
运行后如下图:
那里我标了一个箭头,意思就是有的Android Studio显示的若不是这个界面就去点击一下就好了(若是再不可以,那就去按照官方给的文档去获取就好了),然后就获取到正确的SHA1值啦!然后我们那个界面就能获取到key了。(额…那个获取key的界面,就在登陆账号右边有个api控制台,点进去就有创建应用按钮,点击就好了,然后选项为Android,再输入包名,SHA1,应用的名字就好啦~)。
添加开发者key,在清单文件中的Application中写如下代码(官方也有的):
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="开发者 key" />
添加定位服务代码如下(官方也有…):
<service
android:name="com.baidu.location.f"
android:enabled="true"
android:process=":remote" />
最终效果如下:
上面那个代码中的开发者key写自己申请的哈。
添加相关权限:
这个没什么说的了,直接去官方copy权限就好了,但是若是6.0系统的话,要注意处理下运行时权限哈,要不然会出错的,所有需要的权限如下:
<uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.GET_TASKS" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<!-- 这个权限用于进行网络定位-->
<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" />
添加地图控件:
这个……也没啥,直接去官方copy就好了,如下:
<com.baidu.mapapi.map.MapView
android:id="@+id/bmapView"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:clickable="true" />
这里要注意的是,根布局下就必须是该控件,不能有其他的,要不然会报错的。
- 显示地图+定位
这个,就不再说了,直接上代码吧,所有的都在代码中注释好了,如下:
声明的变量:
private static final String TAG = "MainActivity";
private MapView mMapView;
private BaiduMap mBaiduMap;
//定位
public LocationClient mLocationClient = null;
public BDLocationListener myListener = new MyLocationListener();
onCreate方法:
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
//不能放在加载布局后
SDKInitializer.initialize(getApplicationContext());
setContentView(R.layout.activity_main);
//初始化控件
initView();
}
initView方法:
private void initView() {
mMapView = (MapView) findViewById(R.id.bmapView);
mBaiduMap = mMapView.getMap();
//声明LocationClient类
mLocationClient = new LocationClient(getApplicationContext());
//注册监听函数
mLocationClient.registerLocationListener(myListener);
//初始化定位
initLocation();
//开启定位
mLocationClient.start();
}
initLocation方法:
private void initLocation() {
LocationClientOption option = new LocationClientOption();
////可选,默认高精度,设置定位模式,高精度,低功耗,仅设备
option.setLocationMode(LocationClientOption.LocationMode.Hight_Accuracy);
//可选,默认gcj02,设置返回的定位结果坐标系
option.setCoorType("bd09ll");
int span = 0;
//可选,默认0,即仅定位一次,设置发起定位请求的间隔需要大于等于1000ms才是有效的
option.setScanSpan(span);
//可选,设置是否需要地址信息,默认不需要
option.setIsNeedAddress(true);
//可选,默认false,设置是否使用gps
option.setOpenGps(true);
//可选,默认false,设置是否当GPS有效时按照1S/1次频率输出GPS结果
option.setLocationNotify(true);
//可选,默认false,设置是否需要位置语义化结果,可以在BDLocation.getLocationDescribe里得到,结果类似于“在北京天安门附近”
option.setIsNeedLocationDescribe(true);
//可选,默认false,设置是否需要POI结果,可以在BDLocation.getPoiList里得到
option.setIsNeedLocationPoiList(true);
//可选,默认true,定位SDK内部是一个SERVICE,并放到了独立进程,设置是否在stop的时候杀死这个进程,默认不杀死
option.setIgnoreKillProcess(false);
//可选,默认false,设置是否收集CRASH信息,默认收集
option.SetIgnoreCacheException(false);
//可选,默认false,设置是否需要过滤GPS仿真结果,默认需要
option.setEnableSimulateGps(false);
mLocationClient.setLocOption(option);
}
MyLocationListener(定位回调):
//定位的回调
public class MyLocationListener implements BDLocationListener {
@Override
public void onReceiveLocation(BDLocation location) {
//Receive Location
StringBuffer sb = new StringBuffer(256);
sb.append("time : ");
sb.append(location.getTime());
sb.append("\nerror code : ");
sb.append(location.getLocType());
sb.append("\nlatitude : ");
sb.append(location.getLatitude());
sb.append("\nlontitude : ");
sb.append(location.getLongitude());
sb.append("\nradius : ");
sb.append(location.getRadius());
// GPS定位结果
if (location.getLocType() == BDLocation.TypeGpsLocation) {
sb.append("\nspeed : ");
sb.append(location.getSpeed());// 单位:公里每小时
sb.append("\nsatellite : ");
sb.append(location.getSatelliteNumber());
sb.append("\nheight : ");
sb.append(location.getAltitude());// 单位:米
sb.append("\ndirection : ");
sb.append(location.getDirection());// 单位度
sb.append("\naddr : ");
sb.append(location.getAddrStr());
sb.append("\ndescribe : ");
sb.append("gps定位成功");
// 网络定位结果
} else if (location.getLocType() == BDLocation.TypeNetWorkLocation) {
sb.append("\naddr : ");
sb.append(location.getAddrStr());
//运营商信息
sb.append("\noperationers : ");
sb.append(location.getOperators());
sb.append("\ndescribe : ");
sb.append("网络定位成功");
// 离线定位结果
} else if (location.getLocType() == BDLocation.TypeOffLineLocation) {
sb.append("\ndescribe : ");
sb.append("离线定位成功,离线定位结果也是有效的");
} else if (location.getLocType() == BDLocation.TypeServerError) {
sb.append("\ndescribe : ");
sb.append("服务端网络定位失败,可以反馈IMEI号和大体定位时间到loc-bugs@baidu.com,会有人追查原因");
} else if (location.getLocType() == BDLocation.TypeNetWorkException) {
sb.append("\ndescribe : ");
sb.append("网络不同导致定位失败,请检查网络是否通畅");
} else if (location.getLocType() == BDLocation.TypeCriteriaException) {
sb.append("\ndescribe : ");
sb.append("无法获取有效定位依据导致定位失败,一般是由于手机的原因,处于飞行模式下一般会造成这种结果,可以试着重启手机");
}
sb.append("\nlocationdescribe : ");
// 位置语义化信息
sb.append(location.getLocationDescribe());
// POI数据
List<Poi> list = location.getPoiList();
if (list != null) {
sb.append("\npoilist size = : ");
sb.append(list.size());
for (Poi p : list) {
sb.append("\npoi= : ");
sb.append(p.getId() + " " + p.getName() + " " + p.getRank());
}
}
//定位的结果
Log.d(TAG, "定位结果 " + sb.toString());
//移动到我的位置
//设置缩放,确保屏幕内有我
MapStatusUpdate mapUpdate = MapStatusUpdateFactory.zoomTo(18);
mBaiduMap.setMapStatus(mapUpdate);
//开始移动
MapStatusUpdate mapLatlng = MapStatusUpdateFactory.
newLatLng(new LatLng(location.getLatitude(), location.getLongitude()));
mBaiduMap.setMapStatus(mapLatlng);
//绘制图层
//定义Maker坐标点
LatLng point = new LatLng(location.getLatitude(), location.getLongitude());
//构建Marker图标
BitmapDescriptor bitmap = BitmapDescriptorFactory.fromResource(R.drawable.ic_location);
//构建MarkerOption,用于在地图上添加Marker
OverlayOptions option = new MarkerOptions().position(point).icon(bitmap);
//在地图上添加Marker,并显示
mBaiduMap.addOverlay(option);
}
@Override
public void onConnectHotSpotMessage(String s, int i) {
}
}
绑定生命周期:
@Override
protected void onDestroy() {
super.onDestroy();
mMapView.onDestroy();
}
@Override
protected void onResume() {
super.onResume();
mMapView.onResume();
}
@Override
protected void onPause() {
super.onPause();
mMapView.onPause();
}
OK,这就是所有的代码了,相信大家可以看懂的,还有一个就是,这不只是copy官网的代码,只是实在是不得不copy了,但是官方的文档写的……额,说真的,不咋滴,哈哈,还是看下效果吧,如下:
手机定位显示:
打印log为:
哈哈,是可以成功运行的。
大家若是有什么不懂的,可以在下面评论区中留言哈,我看到后会回的,另外对android有兴趣的同学可以加我们程序员刘某人的群:555974449(若满则加后面的)、484167109,群里面有很多大神的,而且很热情,很热心的,大家不懂的可以问的。
代码已经上传的GitHub,链接如下: