接上文
申请密钥、获取发布版和调试版的SHA1
https://blog.csdn.net/nishigesb123/article/details/89638072
好吧 官方文档实在是写的太太太详细了,感觉我这样的傻子都看得懂,夸一夸百度,别家的地图SDK也这样嘛,改天去看一下。2333
所以...这篇基本是复制文档的
http://lbsyun.baidu.com/index.php?title=androidsdk/guide/create-map/showmap
Hello BaiduMap
百度地图SDK为开发者提供了便捷的使用百度地图能力的接口,通过以下几步操作,即可在您的应用中使用百度地图:
第一步
配置AndroidManifest.xml文件
1.在<application>中加入如下代码配置开发密钥(AK):
<application>
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="开发者 key" />
</application>
这里的开发者Key指的是刚才一顿操作搞到的AK,复制即可
2. 在<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" />
注:自Android6.0起部分权限的使用需要开发者在代码中动态申请。
第二步
在布局文件中添加地图容器
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" />
第三步
地图初始化
这一步的话就在项目右键创建一个class然后按照示例代码编写就好,然后按照下面的说明在配置文件里进行声明。
注意:在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。
多实例显示地图
开发者可以在一个页面中建立多个地图对象,并且针对这些对象分别操作且不会产生相互干扰。 示例代码:在布局文件中添加多个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);
}