前言
首先承认一下今天在水博客,百度地图的SDK大概一个月前刚刚接触到,当时学习完就做了个demo,把常用的功能实现一下。正好最紧构思好了一个项目需要用到地图SDK,这篇一是打卡水博,二是权当复习了,为过几天的项目做准备。
获取开发密钥(AK)
尽管自认为是保姆级教程,但我想我记性应该不能差到忘记怎么注册账号。不过SDK官网网址贴一下:http://lbsyun.baidu.com/,完后去获取开发密钥http://lbsyun.baidu.com/apiconsole/key#/home,官网给出了获取密钥的教程:http://lbsyun.baidu.com/index.php?title=androidsdk/guide/create-project/ak。
获取包名
为获取开发密钥,我们需要获取当前项目的包名和SHA密钥,包名在AndroidManifests.xml中已经定义,如下:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.mweather">
获取SHA密钥
我们应注意SHA的版本,此处引用官网教程上的一段话:
调试版本(debug)和发布版本(release)下的 SHA1 值是不同的,发布 apk 时需要根据发布 apk 对应的 keystore 重新配置 Key。(注意:我们这里使用的是调试版本,在开发时请使用调试版本) 。
进入控制台,并输入下列命令:
keytool -genkey -alias android.keystore -keyalg RSA -validity 20000 -keystore 密钥生成路径
在控制台中输入下列命令
keytool -list -v -keystore android.keystore -storepass 密钥口令 查看刚刚生成的密钥
获取AK
在刚刚给出获取AK的连接中,输入包名和SHA密钥即可创建
下载并导入jar包
去http://lbs.baidu.com/index.php?title=sdk/download&action#selected=mapsdk_basicmap,mapsdk_searchfunction,mapsdk_lbscloudsearch,mapsdk_calculationtool,mapsdk_radar下jar包,根据需求选择需要的功能。
随后在AS中导入jar包。
将jar包放入项目目录下的/app/libs目录中,初次之外将项目所需的cpu架构的文件也拷贝到该目录下。
随后在build.gradle中配置sorceSets,在build.gradle(Module:app)中添加以下代码:
sourceSets {
main {
jniLibs.srcDir 'libs'
}
}
在工程中添加jar文件
将左侧窗口中的Android标签切换为Project标签,由此看到刚刚拷贝的jar和so文件
右键点击jar包->点选Add As Library,随后选择添加到app中(直接点ok即可,此处就不截图了)
配置混淆文件
因为我们要防止百度地图SDK相关内容不被混淆,所以我们需要配置混淆文件。
打开app目录下的build.gradle(Module:app)文件,在release代码块中添加如下内容(若已经由Android Studio自动生成,则不用手动配置)。
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
}
编写混淆文件,打开app目录下的proguard-rules.pro文件,添加如下代码。
-keep class com.baidu.** {*;}
-keep class mapsdkvi.com.** {*;}
-dontwarn com.baidu.**
显示地图
初始化地图服务
定义DemoApplication,重写onCreate()方法
public class DemoApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
//在使用SDK各组件之前初始化context信息,传入ApplicationContext
SDKInitializer.initialize(this);
//自4.3.0起,百度地图SDK所有接口均支持百度坐标和国测局坐标,用此方法设置您使用的坐标类型.
//包括BD09LL和GCJ02两种坐标,默认是BD09LL坐标。
SDKInitializer.setCoordType(CoordType.BD09LL);
}
}
配置AndroidManifests.xml
在manifest文件中配置application,将刚刚获得的AK值配置好
<application>
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="此处输入AK值" />
</application>
因为改SDK需要诸多系统权限,因此在配置manifest时应当添加权限声明
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<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 android:name="android.permission.ACCESS_FINE_LOCATION" />
在布局文件中添加地图容器
<com.baidu.mapapi.map.MapView
android:id="@+id/bmapView"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:clickable="true" />
在manifest文件中声明application和service
Application标签
<application
android:name=".DemoApplication" >
Service标签
<service android:name="com.baidu.location.f"
android:enabled="true"
android:process=":remote" />
获取定位数据
自定义MyLocationListener,SDK通过重写BDAbstractLocationListener,并重写其中的onReceiveLocation方法来实现定位数据的获取,并可将定位数据传给MapView
public class MyLocationListener extends BDAbstractLocationListener {
@Override
public void onReceiveLocation(BDLocation location) {
//mapView 销毁后不在处理新接收的位置
if (location == null || mMapView == null){
return;
}
MyLocationData locData = new MyLocationData.Builder()
.accuracy(location.getRadius())
// 此处设置开发者获取到的方向信息,顺时针0-360
.direction(location.getDirection()).latitude(location.getLatitude())
.longitude(location.getLongitude()).build();
mBaiduMap.setMyLocationData(locData);
}
}
自定义Activity
重写Activity中的onCreate()方法,直接启动布局即可。
public class MainActivity extends AppCompatActivity {
private final int SDK_PERMISSION_REQUEST = 127;
private static String permissionInfo = null;
private static BaiduMap mBaiduMap;
private static MapView mMapView;
private static LocationClient mLocationClient;
public class MyLocationListener extends BDAbstractLocationListener {
@Override
public void onReceiveLocation(BDLocation location) {
//mapView 销毁后不在处理新接收的位置
if (location == null || mMapView == null){
return;
}
MyLocationData locData = new MyLocationData.Builder()
.accuracy(location.getRadius())
// 此处设置开发者获取到的方向信息,顺时针0-360
.direction(location.getDirection()).latitude(location.getLatitude())
.longitude(location.getLongitude()).build();
mBaiduMap.setMyLocationData(locData);
}
}
protected void onCreate(Bundle savedInstanceState){
getPersimmions();
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mMapView = (MapView) findViewById(R.id.bmapView);
mBaiduMap = mMapView.getMap();
mBaiduMap.setMyLocationEnabled(true);
//注册LocationListener监听器
MyLocationListener myLocationListener = new MyLocationListener();
mLocationClient.registerLocationListener(myLocationListener);
//定位初始化
mLocationClient = new LocationClient(this);
//通过LocationClientOption设置LocationClient相关参数
LocationClientOption option = new LocationClientOption();
option.setOpenGps(true); // 打开gps
option.setCoorType("bd09ll"); // 设置坐标类型
option.setScanSpan(1000);
//设置locationClientOption
mLocationClient.setLocOption(option);
//开启地图定位图层
mLocationClient.start();
}
@Override
protected void onResume() {
mMapView.onResume();
super.onResume();
}
@Override
protected void onPause() {
mMapView.onPause();
super.onPause();
}
@Override
protected void onDestroy() {
mLocationClient.stop();
mBaiduMap.setMyLocationEnabled(false);
mMapView.onDestroy();
mMapView = null;
super.onDestroy();
}
Android6.0以后的版本应当手动获取权限,代码如下:
//获取权限
@TargetApi(23)
private void getPersimmions() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
ArrayList<String> permissions = new ArrayList<String>();
/***
* 定位权限为必须权限,用户如果禁止,则每次进入都会申请
*/
// 定位精确位置
if (checkSelfPermission(Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
permissions.add(Manifest.permission.ACCESS_FINE_LOCATION);
}
if (checkSelfPermission(Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
permissions.add(Manifest.permission.ACCESS_COARSE_LOCATION);
}
/*
* 读写权限和电话状态权限非必要权限(建议授予)只会申请一次,用户同意或者禁止,只会弹一次
*/
// 读写权限
if (addPermission(permissions, Manifest.permission.WRITE_EXTERNAL_STORAGE)) {
permissionInfo += "Manifest.permission.WRITE_EXTERNAL_STORAGE Deny \n";
}
if (permissions.size() > 0) {
requestPermissions(permissions.toArray(new String[permissions.size()]), SDK_PERMISSION_REQUEST);
}
}
}
@TargetApi(23)
private boolean addPermission(ArrayList<String> permissionsList, String permission) {
// 如果应用没有获得对应权限,则添加到列表中,准备批量申请
if (checkSelfPermission(permission) != PackageManager.PERMISSION_GRANTED) {
if (shouldShowRequestPermissionRationale(permission)) {
return true;
} else {
permissionsList.add(permission);
return false;
}
} else {
return true;
}
}
@TargetApi(23)
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
// TODO Auto-generated method stub
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
}
}