百度地图
简介
百度地图SDK是一套应用程序接口, 通过调用地图SDK接口,开发者可以轻松访问百度地图的服务和数据,构建功能丰富、交互性强的地图类应用程序。
您可以通过该接口实现丰富的LBS功能:
开发者可在百度地图android SDK的下载页面下载到最新的地图SDK
下载地址为:
老官网:http://developer.baidu.com/map 仍可以跳转
申请秘钥
在申请密钥前还得激活开发者账号…按提示输入信息,激活完就可以申请密钥了
获取包名
获取SHA1,打开cmd进入.android文件夹下
记住两个命令
- 调试版本使用指令:keytool -list -v -keystore debug.keystore
- 发布版本请使用指令:keytool -list -v -keystore apk 的 keystore
调试版本(在开发时请使用调试版本)
若显示以下错误
则找到Java安装路径下找到keytool.exe;打开运行先转到你的keytool文件夹路径下,然后回车。再运行它(输入keytool.exe 快捷键是Tab建和Linux一样),然后在后边输入命令 -list -keystore 输上后后边跟的就是你的debug.keystore文件的对象路径。然后提示输入密库口令 输入android ,好再回车就看见你的Sha1了。
配置开发环境
首先你得下载SDK
下载所需要的功能后,解压,看到一个很明显的jar包
复制到项目的libs里
右键add as…
然后是so文件,跟之前使用某框架差不多,在src/main/目录下新建一个jniLibs目录,然后把刚才解压出来的除了jar包都扔进去
Hello BaiduMap
百度地图SDK为开发者提供了便捷的使用百度地图能力的接口,通过以下几步操作,即可在您的应用中使用百度地图:
参考:http://lbsyun.baidu.com/index.php?title=androidsdk/guide/create-map/showmap
第一步:配置AndroidManifest.xml文件
1.在<application>
中加入如下代码配置开发密钥(AK):
<application>
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="开发者 key" />
</application>
开发者 key就是之前申请的秘钥
- 在
<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" />
//这个权限用于访问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" />
第二步 在布局文件中添加地图容器
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" />
第三步 地图初始化
注意:在SDK各功能组件使用之前都需要调用“SDKInitializer.initialize(getApplicationContext())”,因此建议在应用创建时初始化SDK引用的Context为全局变量。
新建一个自定义的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);
}
}
在AndroidManifest.xml文件中声明该Application
第四步 创建地图Activity,管理MapView生命周期
public class MainActivity extends Activity {
private MapView mMapView = null;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
//获取地图控件引用
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();
}
}
完成以上工作即可在您的应用中显示地图:
通过添加View显示地图
百度地图SDK支持不用通过layout文件中添加MapView控件,直接在Java代码中添加MapView的方式来展示地图,示例如下:
1 创建MapView对象
MapView mapView = new MapView(this);
2添加MapView对象
setContentView(mapView);
另外,在Java代码中添加MapView的方式支持通过BaiduMapOptions对象根据需求构造包含特定地图状态类型和控件显示状态的MapView对象。示例如下:
1 定义BaiduMapOptions对象
BaiduMapOptions options = new BaiduMapOptions();
2设置需要的状态
//设置地图模式为卫星地图
options.mapType(BaiduMap.MAP_TYPE_SATELLITE);
3创建MapView对象
MapView mapView = new MapView(this, options);
4添加MapView对象
setContentView(mapView);
BaiduMapOptions类支持设置的状态如下:
状态 | 含义 |
---|---|
mapStatus | 地图状态 |
compassEnable | 是否开启指南针,默认开启 |
mapType | 地图模式,默认为普通地图 |
rotateGesturesEnabled | 是否允许地图旋转手势,默认允许 |
scrollGesturesEnabled | 是否允许拖拽手势,默认允许 |
overlookingGesturesEnabled | 是否允许俯视图手势,默认允许 |
zoomControlsEnabled | 是否显示缩放按钮控件,默认允许 |
zoomControlsPosition | 设置缩放控件位置 |
zoomGesturesEnabled | 是否允许缩放手势,默认允许 |
scaleControlEnabled | 是否显示比例尺控件,默认显示 |
scaleControlPosition | 设置比例尺控件位置 |
logoPosition | 设置Logo位置 |
地图类型及显示层级
- 百度地图SDK支持21级的地图显示,如下为地图类型和图层支持层级说明
地图类型或图层 | 显示层级 |
---|---|
2D地图 | 4-21 |
3D地图 | 19-21 |
卫星图 | 4-20 |
路况交通图 | 11-21 |
百度城市热力图 | 11-21 |
室内图 | 17-22 |
- 下表为显示层级与比例尺的对应关系
显示层级 | 比例尺/米 |
---|---|
4 | 1000000 |
5 | 500000 |
6 | 200000 |
7 | 100000 |
8 | 50000 |
9 | 25000 |
10 | 20000 |
11 | 10000 |
12 | 5000 |
13 | 2000 |
14 | 1000 |
15 | 500 |
16 | 200 |
17 | 100 |
18 | 50 |
19 | 20 |
20 | 10 |
21 | 5 |
注意:检查室内图当前状态,自v5.0.0起,将地图缩放等级由3-21调整为4-21,优化南北极地区展示效果(当开启室内图时,最大缩放等级增大至22级),请开发者注意。
可以通过如下代码设置地图的缩放级别:
MapStatus.Builder builder = new MapStatus.Builder();
builder.zoom(18.0f);
mBaiduMap.setMapStatus(MapStatusUpdateFactory.newMapStatus(builder.build()));
常用地图容器
地图SDK底层运用两种GLSurfaceView和TextureView两种OpenGL ES组件构建地图。下面简要介绍。
- GLSurfaceView:
包括MapView,MapFragment和SupportMapFragment三种容器。MapFragment和SupportMapFragment用于在 Android Fragment 中放置地图。适合需要使用Fragment的开发场景,方便您实现灵活的布局。MapFragment和SupportMapFragment分别是android.app.Fragment和android.support.v4.app,Fragment的子类,MapFragment需要在android3.0以上的版本中使用。
- TextureView:
包括TexureMapView,TextureMapFragment和TextureSupportMapFragment三种容器。使用场景:您将MapView与其他的GLSurfaceView(比如相机)叠加展示,或者是在ScrollView中加载地图时,建议使用TextureMapView及SupportTextureMapFragment来展示地图,可以有效解决 GLSurfaceView 叠加时出现的穿透、滚动黑屏等问题。如果使用TextureMapView请确保:Android 4.4以上系统,在AndroidManifest.xml中配置硬件加速选项。
SupportMapFragment
此处示例代码简要介绍SupportMapFragment使用。
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_fragment);
manager = getSupportFragmentManager();
//获取到SupportMapFragment实例
mSupportMapFragment = SupportMapFragment.newInstance(mapOptions);
//将fragment添加至Activity
manager.beginTransaction().add(R.id.map_container, mapFragment).commit();
}
另外,您也可以使用replace的方法替换已有的fragment。
manager.beginTransaction().replace(R.id.map_container, mapFragment).commit();
多实例显示地图
开发者可以在一个页面中建立多个地图对象,并且针对这些对象分别操作且不会产生相互干扰。 示例代码:在布局文件中添加多个SupportMapFragment
<fragment
android:id="@+id/map1"
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_margin="5dp"
android:layout_weight="1"
class="com.baidu.mapapi.map.SupportMapFragment" />
<fragment
android:id="@+id/map2"
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_margin="5dp"
android:layout_weight="1"
class="com.baidu.mapapi.map.SupportMapFragment" />
在Activity中管理地图容器
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_multi_map_demo);
LatLng GEO_BEIJING = new LatLng(39.945, 116.404);
LatLng GEO_SHANGHAI = new LatLng(31.227, 121.481);
//北京为地图中心,logo在左上角
MapStatusUpdate status1 = MapStatusUpdateFactory.newLatLng(GEO_BEIJING);
SupportMapFragment map1 = (SupportMapFragment) (getSupportFragmentManager()
.findFragmentById(R.id.map1));
map1.getBaiduMap().setMapStatus(status1);
map1.getMapView().setLogoPosition(LogoPosition.logoPostionleftTop);
//上海为地图中心
MapStatusUpdate status2 = MapStatusUpdateFactory.newLatLng(GEO_SHANGHAI);
SupportMapFragment map2 = (SupportMapFragment) (getSupportFragmentManager()
.findFragmentById(R.id.map2));
map2.getBaiduMap().setMapStatus(status2);
}
基础地图
普通地图
mMapView = (MapView) findViewById(R.id.bmapView);
mBaiduMap = mMapView.getMap();
//普通地图 ,mBaiduMap是地图控制器对象
mBaiduMap.setMapType(BaiduMap.MAP_TYPE_NORMAL);
卫星图
//获取地图控件引用
mMapView = (MapView) findViewById(R.id.bmapView);
baiduMap=mMapView.getMap();//获取地图
baiduMap.setMapType(BaiduMap.MAP_TYPE_SATELLITE);
交通地图,只需添加下面一段代码
baiduMap.setTrafficEnabled(true);
标注覆盖物
//定义Maker坐标点
LatLng point = new LatLng(39.963175, 116.400244);//经纬度
//构建Marker图标
BitmapDescriptor bitmap = BitmapDescriptorFactory.fromResource(R.mipmap.zz2);
//构建MarkerOption,用于在地图上添加Marker
OverlayOptions option = new MarkerOptions().position(point).icon(bitmap);
//在地图上添加Marker,并显示
baiduMap.addOverlay(option);
详细参考相关文档:http://lbsyun.baidu.com/index.php?title=androidsdk/guide/create-map/maptype
POI检索
POI(Point of Interest),即“兴趣点”。在地理信息系统中,一个POI可以是一栋房子、一个景点、一个邮筒或者一个公交站等。
百度地图SDK提供三种类型的POI检索:城市内检索、周边检索和区域检索(即矩形区域检索)。下面分别对三种POI检索服务的使用方法作说明。
城市内检索
实例化POI检索工具
poiSearch=PoiSearch.newInstance();
创建POI检索监听器
OnGetPoiSearchResultListener poiSearchResultListener=new OnGetPoiSearchResultListener() {
@Override
public void onGetPoiResult(PoiResult poiResult) {
//获取POI检索结果
}
@Override
public void onGetPoiDetailResult(PoiDetailResult poiDetailResult) {
//获取place详情页检索结果
}
@Override
public void onGetPoiDetailResult(PoiDetailSearchResult poiDetailSearchResult) {
}
@Override
public void onGetPoiIndoorResult(PoiIndoorResult poiIndoorResult) {
}
};
//设置检索监听器
poiSearch.setOnGetPoiSearchResultListener(poiSearchResultListener);
发起一个检索请求
/**
* PoiCiySearchOption 设置检索属性
* city 检索城市
* keyword 检索内容关键字
* pageNum 分页页码
*/
//发起一个检索请求,异步过程
poiSearch.searchInCity((new PoiCitySearchOption())
.city("北京")
.keyword("美食")
.pageNum(10));
释放检索实例
poiSearch.destroy();
获取POI检索结果,并标注
public void onGetPoiResult(PoiResult poiResult) {
//获取POI检索结果
List<PoiInfo> poiInfos=poiResult.getAllPoi();
for (PoiInfo p:poiInfos){
Log.i("food",p.address+"-"+p.city+"-"+p.phoneNum);
BitmapDescriptor bd=BitmapDescriptorFactory.fromResource(R.mipmap.ic_launcher);
OverlayOptions option = new MarkerOptions()
.position(p.location)
.icon(bd);
baiduMap.addOverlay(option);
}
}
详细参考文档:http://lbsyun.baidu.com/index.php?title=androidsdk/guide/search/poi
定位
配置AndroidManifest.xml文件
<!-- 这个权限用于进行网络定位 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 这个权限用于访问GPS定位 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<service android:name="com.baidu.location.f"
android:enabled="true"
android:process=":remote"/>
开启地图的定位图层
mBaiduMap.setMyLocationEnabled(true);
构造地图数据
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);
}
}
通过LocationClient发起定位
//定位初始化
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();
mLocationClient.requestLocation();//发送请求
正确管理各部分的生命周期
@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();
}
详细参考文档:http://lbsyun.baidu.com/index.php?title=androidsdk/guide/create-map/location