【百度地图学习-一】初始化以及TextOverlay
一、百度地图的初始化
主要用到三个类：
1、BMapManager：使用地图sdk前需先初始化BMapManager.BMapManager是全局的，可为多个MapView共用，它需要地图模块创建前创建， 并在地图地图模块销毁后销毁，只要还有地图模块在使用，BMapManager就不应该销毁。它属于地图引擎管理类。
最好在用一个自定义的继承于Application的类来依附Activity的生命周期，它有四个常用方法：
public boolean start() //开启百度地图API
public boolean stop() //终止百度地图API，调用此函数后，不会再发生回调
public void destroy() //在程序退出前调用
public boolean init(java.lang.String strKey,MKGeneralListener listener)//其中的参数：
strKey- 申请的授权验证码,
listener- 注册回调事件
package org.hjw.hellobaidu; import com.baidu.mapapi.BMapManager; import com.baidu.mapapi.MKGeneralListener; import com.baidu.mapapi.map.MKEvent; import android.app.Application; import android.content.Context; import android.widget.Toast; public class MapApplication extends Application { /** * 使用地图sdk前需先初始化BMapManager. * BMapManager是全局的，可为多个MapView共用，它需要地图模块创建前创建， * 并在地图地图模块销毁后销毁，只要还有地图模块在使用，BMapManager就不应该销毁 */ private static MapApplication mInstance = null; public boolean m_keyRight = true; BMapManager bMapManager = null;//地图管理引擎 public static final String mapKey = "sEtVxB4uwzTRlchScMcELXu8"; @Override public void onCreate() { super.onCreate(); mInstance = this; initMapManager(this); } private void initMapManager(Context context) { if(bMapManager==null){ bMapManager = new BMapManager(context); } if(!bMapManager.init(mapKey, new GeneralListner())){ Toast.makeText(MapApplication.getInstance().getApplicationContext(), "BMapManager 初始化错误!", Toast.LENGTH_LONG).show(); } } public static MapApplication getInstance(){ return mInstance; } static class GeneralListner implements MKGeneralListener{ @Override public void onGetNetworkState(int arg0) { if(arg0 ==MKEvent.ERROR_NETWORK_CONNECT){ Toast.makeText(MapApplication.getInstance().getApplicationContext(), "网络出错啦！", Toast.LENGTH_LONG).show(); }else if(arg0 ==MKEvent.ERROR_NETWORK_DATA){ Toast.makeText(MapApplication.getInstance().getApplicationContext(), "请输入正确的检索条件！", Toast.LENGTH_LONG).show(); } } @Override public void onGetPermissionState(int iError) { if(iError!=0){ Toast.makeText(MapApplication.getInstance().getApplicationContext(), "请输入正确Mapkey！", Toast.LENGTH_LONG).show(); MapApplication.getInstance().m_keyRight=false; }else{ Toast.makeText(MapApplication.getInstance().getApplicationContext(), "MapKey认证成功！", Toast.LENGTH_LONG).show(); MapApplication.getInstance().m_keyRight=true; } } } }
2、MapView类：它直接继承于ViewGroup，显示地图的View，一个显示地图的视图，当被焦点选中时，它能捕获按键事件和触摸手势去平移和缩放地图。
MapView的生命周期与Activity同步，当activity挂起时需调用MapView.onPause()。必须在setContentview后才可以使用mapView，同时也包含了对覆盖物的管理等。
3、MapController类：它是地图控制器，通过mapView对象获得，同时也取得了对mapView的各种操作权限，包括缩放大小，显示不同类型的图等等。
4、MKMapViewListener接口：地图显示事件监听器。 该接口监听地图显示事件，用户需要实现该接口以处理相应事件，包含下面四个方法。
{
void onClickMapPoi(MapPoi mapPoiInfo)
点击到地图可点标注时会回调此接口
void onGetCurrentMap(Bitmap b)
截图成功后会回调此接口
void onMapAnimationFinish()
动画结束时会回调此消息
void onMapLoadFinish()
在图加载完成回调
}
void onMapMoveFinish()
地图移动完成时会回调此接口
重写方法时，必须通过mapView对象注册监听器。
mapView.regMapViewListener(MapApplication.getInstance().bMapManager,mkMapViewListener);// 用户注册地图监听器
二、文字覆盖物的实现
分为以下几步：
1. 用TextItem准备文字数据
2. 创建TextOverlay,调用 addText(TextItem) 接口添加文字.
3. 调用MapView.getOverlays().add()方法添加overlay到mapview中。
4. 调用MapView.refresh() 使Overlay生效。
实现代码：
TextItem textItem = new TextItem(); textItem.fontColor = textColor1; //textItem.bgColor = textColor1; textItem.fontSize = 20; textItem.text = "这里是中心广场"; textItem.pt = mapView.getMapCenter(); TextOverlay textOverlay = new TextOverlay(mapView); textOverlay.addText(textItem); mapView.getOverlays().add(textOverlay); mapView.refresh();
其中对于TextItem类中的fontColor和fontSize是必须赋值的，否则地图上面会看不到的。
下面是效果图：
那个很小的”这里是中心广场”就是覆盖物，因此需适量调整字体大小。其中TextItem中的fontSize和fontColor是必须要设置的，这是在百度sdk2.0之后才需要这样，2.0之前都是直接继承基类Overlay重写Draw方法。
还有一点就是官方提供的Demo里面，GeoPoint的初始化，参数分别为纬度和经度，Demo里面弄反了，所以可能会导致地图显示空白，只有小格子。这个问题纠结了好久。
