地图的简单使用
一.注册百度地图账号
二.点击控制台,创建应用
1.填写应用名称,选中类型为:Android SDK,发布版/开发版SHA1参考百度文档完成
http://lbsyun.baidu.com/index.php?title=androidsdk/guide/create-project/ak
2.获取SHA1值
在Studio中最右边Gradle找对对应的mode-tasks-signingReport点击会在log中打印出来
在百度开放平台中使用
3.应用创建完成后Ak需要使用
image.png
三.Android Studio配置
1.开始下载自己需要的开发包类型下载
image.png
2.将开发包拷贝至工程(截图以普通地图服务的开发包为例,步骑行导航的开发包同理),百度有坑,开发包总下载失败或者不全,从demo里面搞对应的jar和so文件
a:添加jar文件
打开解压后的开发包文件夹,找到BaiduLBS_Android.jar文件将其拷贝至工程的app/libs目录下,如图:
image.png
b.添加so文件
有两种方法可以往项目中添加so文件。
方法一:
在下载的开发包中拷贝需要的CPU架构对应的so文件文件夹到app/libs目录下,如图:
image.png
在app目录下的build.gradle文件中android块中配置sourceSets标签,如果没有使用该标签
则新增,详细配置代码如下:
sourceSets {
main {
jniLibs.srcDir 'libs'
}
}
我们一般使用的是加代码的这种
注意:Jar文件和so文件的版本号必须一致,并且保证Jar文件与so文件是同一版本包取出的。
资源说明
V5.1.0版本起,为了优化SDK的jar包体积,将一些Demo中用到的图片资源文件从SDK的jar包中移到了Demo的资源文件路径下,若有依赖,请在Demo中的资源路径获取,源码Demo下载。路径如下:
BaiduMapsApiASDemo/app/src/main/assets/
注意:若您下载的开发包是步骑行导航的,在解压后的开发包中会包含一个assets目录,您需要将该目录下的png文件拷贝至您的项目的assets目录下。
3.配置AndroidManifest.xml文件
a.在<application>中加入如下代码配置开发密钥(AK):
<!-- 开始 -->
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="TxVVKWGtNIpWVjS5Y0xb2PYgl1lrlxXb" />
<service
android:name="com.baidu.location.f"
android:enabled="true"
android:process=":remote" />
<!-- 结束 -->
b. 在<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" />
<!-- //允许sd卡写权限,需写入地图数据,禁用后无法显示地图 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- //这个权限用于进行网络定位 -->
<uses-permission android:name="android.permission.WRITE_SETTINGS"
tools:ignore="ProtectedPermissions" />
<!-- //这个权限用于访问GPS定位 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- //获取统计数据 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- //使用步行AR导航,配置Camera权限 -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- //程序在手机屏幕关闭后后台进程仍然运行 -->
<uses-permission android:name="android.permission.WAKE_LOCK" />
注:自Android6.0起部分权限的使用需要开发者在代码中动态申请。
4.地图初始化
新建一个自定义的Application,在其onCreate方法中完成SDK的初始化。示例代码如下:
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);
}
}
记住一定要在清单文件中注册
四.使用
1.在布局文件中添加地图容器
MapView是View的一个子类,用于在Android View中放置地图。MapView的使用方法与Android提供的其他View一样。
<com.baidu.mapapi.map.MapView
android:id="@+id/bmapView"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:clickable="true" />
2.创建地图Activity,管理MapView生命周期,地图就显示出来了
private void initView() {
mMapView = (MapView) findViewById(R.id.bmapView);
}
@Override
protected void onResume() {
super.onResume();
//在activity执行onResume时执行mMapView. onResume (),实现地图生命周期管理
mMapView.onResume();
}
@Override
protected void onPause() {
super.onPause();
//在activity执行onPause时执行mMapView. onPause (),实现地图生命周期管理
mMapView.onPause();
}
@Override
protected void onDestroy() {
super.onDestroy();
//在activity执行onDestroy时执行mMapView.onDestroy(),实现地图生命周期管理
mMapView.onDestroy();
}
这个时候地图就可以显示出来啦
3.定位
通过如下几步您便可以在自己的地图中展示当前所在位置的定位点。
(1)确保您的开发包中包含基本定位功能,该选项在您下载开发包时默认不会被选中
image.png
2)配置AndroidManifest.xml文件(不过上面那已经包含啦)
<!-- 这个权限用于进行网络定位 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 这个权限用于访问GPS定位 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
b.在Application标签中声明定位的service组件(这个其实上面也加过啦)
<service android:name="com.baidu.location.f"
android:enabled="true"
android:process=":remote"/>
(3)开启地图的定位图层
mBaiduMap = bmapView.getMap();
mBaiduMap.setMyLocationEnabled(true);
locatition();
mBaiduMap是地图的控件
(4)构造地图数据
我们通过继承抽象类BDAbstractListener并重写其onReceieveLocation方法来获取定位数据,并将其传给MapView。
//---------------------过去地图的数据---------------------------
/*
* 构造地图数据
我们通过继承抽象类BDAbstractListener并重写其onReceieveLocation方法来获取定位数据,并将其传给MapView。*/
public class MyLocationListener extends BDAbstractLocationListener {
@Override
public void onReceiveLocation(BDLocation location) {
mLocation =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);
}
}
(5)通过LocationClient发起定位
private void locatition() {
if (mLocationClient == null) {
//定位初始化
mLocationClient = new LocationClient(this);
//通过LocationClientOption设置LocationClient相关参数
LocationClientOption option = new LocationClientOption();
option.setOpenGps(true); // 打开gps
option.setCoorType("bd09ll"); // 设置坐标类型
option.setScanSpan(1000);
//设置locationClientOption
mLocationClient.setLocOption(option);
//注册LocationListener监听器
MyLocationListener myLocationListener = new MyLocationListener();
mLocationClient.registerLocationListener(myLocationListener);
}
//开启地图定位图层
mLocationClient.start();
}
(6)在生命周期ondestroy方法
@@OverrideOv
protected void onDestroy() {
mLocationClient.stop();
mBaiduMap.setMyLocationEnabled(false);
mMapView.onDestroy();
mMapView = null;
super.onDestroy();
}
(7).权限
String[] per = new String[]{
Manifest.permission.READ_PHONE_STATE,
Manifest.permission.WRITE_EXTERNAL_STORAGE,
Manifest.permission.ACCESS_COARSE_LOCATION,
Manifest.permission.ACCESS_FINE_LOCATION,
Manifest.permission.CAMERA
};
ActivityCompat.requestPermissions(this, per, 100);
点击定位
private void DingWei() {
LatLng latLng = new LatLng(mLocation.getLatitude(), mLocation.getLongitude());
//改变地图手势的中心点
mBaiduMap.setMapStatus(MapStatusUpdateFactory.newLatLng(latLng));
}
具体各种功能可去看文档更加详细