安卓SDK——百度地图（Hello BaiduMap）

接上文

申请密钥、获取发布版和调试版的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);
}