【百度地图学习-一】初始化以及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里面弄反了，所以可能会导致地图显示空白，只有小格子。这个问题纠结了好久。