【百度地图开发之三】百度地图UI控制功能讲解

jerry 地图开发 2015年11月27日收藏

上一篇我们学习了【百度地图开发之二】基于Fragment的地图框架的使用(点击跳转),今天继续看一下百度地图UI视图的一些控制功能.

(一)基本介绍:

百度地图UI控制功能主要包括一些开关手势功能和UI控件的显示与隐藏,(例如:对地图的缩放,平移,双击放大缩小,旋转,俯视,显示与隐藏缩放控件以及指南针的显示位置等功能).要实现以上的功能主要用要到下面两个类中的方法1:MapView(地图View),2:MapController:(地图控制器);下面来简要的看一下其中使用到的方法.

(二)方法说明:

1:MapView:这是显示地图的视图,当该视图获得焦点的时候,可以捕捉触摸事件和点击事件手势去平移地图和缩放地图,MapView的创建我们可以通过XML布局实现，同样也可以用个构造函数去实现.本例中使用XML布局文件。同时还是用到主要下面两个方法:

①:public void setBuiltInZoomControls(boolean on) : 设置是否启用内置的缩放控件。如果on为true,MapView将自动显示这些缩放控件

②:public void setDoubleClickZooming(booean bDoubleClickZooming):设置mapView是否支持双击方法效果；

2: MapController:地图控制器:可以实现地图的手势事件,缩放，平移，选中，俯视等功能，主要用到下面几个方法:

①:public void setZoomGesturesEnabled(boolean isZoomGesturesEnable)：设置缩放手势状态, true,缩放手势开启

②:public void setScrollGesturesEnabled(boolean isScrollGesturesEnable)：是平移手势开关状态,true,平移手势开启

③:public voic setRotationGestureEnabled(boolean isRotationGesturesEnable):设置旋转手势开关状态,true,旋转手势开启

④:public void setOverlookingGesturedEnabled(boolean isOverlookingGesturesEnabled):设置俯视手势开关状态,true 俯视手势开启

除了这些手势方法以外，该控制器还有一些其他的方法，具体的可以到BaiduMap API文档中查看。下面根据上面的方法，我们来看下百度地图中的demo项目(代码中的注释已经写的很详细了)

(三)例子实现:

1. MyApplication.java方法，进行BMapManager全局变量的设置和密钥验证，代码如下:

package com.ztt.baidumap.ui;
 
import android.app.Application;
import android.content.Context;
import android.util.Log;
import android.widget.Toast;
 
import com.baidu.mapapi.BMapManager;
import com.baidu.mapapi.MKGeneralListener;
import com.baidu.mapapi.map.MKEvent;
/**
 * 自定义Application,进行key识别验证 （使用单例）
 * @author Jiangqq
 * @time 2014/03/15 10:14
 */
public class MyApplication extends Application {
    public static MyApplication instance=null;
	BMapManager mBMapManager = null;
	public boolean m_bKeyRight = true;
    public static final String strKey = "vUAGbPwLpolIqiwWisnQPeIE";  //百度地图官网申请的密钥
	public static MyApplication getInstance(){
		return instance;
	}
	@Override
	public void onCreate() {
		super.onCreate();
		instance=this;
		//在APP应用启动的时候，进行初始化验证
		initEngineManager(this);
	}
	
	/**
	 * 进行验证key
	 * @param pContext
	 */
	private void initEngineManager(Context pContext)
	{
		 if (mBMapManager == null) {
	            mBMapManager = new BMapManager(pContext);
	        }
 
	        if (!mBMapManager.init(strKey,new MyGeneralListener())) {
	            Toast.makeText(MyApplication.getInstance(), 
	                    "BMapManager  初始化错误!", Toast.LENGTH_LONG).show();
	        }
	}
	// 常用事件监听，用来处理通常的网络错误，授权验证错误等
    static class MyGeneralListener implements MKGeneralListener {
        
        @Override
        public void onGetNetworkState(int iError) {
            if (iError == MKEvent.ERROR_NETWORK_CONNECT) {
                Toast.makeText(MyApplication.getInstance(), "您的网络出错啦！",
                    Toast.LENGTH_LONG).show();
            }
            else if (iError == MKEvent.ERROR_NETWORK_DATA) {
                Toast.makeText(MyApplication.getInstance(), "输入正确的检索条件！",
                        Toast.LENGTH_LONG).show();
            }else {
				 Log.d("zttjiangqq", "iError="+iError);
			}
            // ...
        }
 
        @Override
        public void onGetPermissionState(int iError) {
        	//非零值表示key验证未通过
            if (iError != 0) {
                //授权Key错误：
                Toast.makeText(MyApplication.getInstance(), 
                        "请在 DemoApplication.java文件输入正确的授权Key,并检查您的网络连接是否正常！error: "+iError, Toast.LENGTH_LONG).show();
                MyApplication.getInstance().m_bKeyRight = false;
            }
            else{
            	MyApplication.getInstance().m_bKeyRight = true;
            	Toast.makeText(MyApplication.getInstance(), 
                        "key认证成功", Toast.LENGTH_LONG).show();
            }
        }
    }
}

2.布局文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
    
  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:orientation="horizontal"
        android:layout_width="fill_parent"
        android:layout_height="50dip">
    
    <CheckBox
        android:id="@+id/zoom"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:checked="true"
        android:onClick="setZoomEnable"
        android:text="缩放" />
    <CheckBox
        android:id="@+id/scroll"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:checked="true"
        android:onClick="setScrollEnable"
        android:text="平移" />
    <CheckBox
        android:id="@+id/doubleClick"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:checked="true"
        android:onClick="setDoubleClickEnable"
        android:text="双击放大" />
  </LinearLayout>
  
  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:orientation="horizontal"
        android:layout_width="fill_parent"
        android:layout_height="50dip">
    
    <CheckBox
        android:id="@+id/rotate"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:checked="true"
        android:onClick="setRotateEnable"
        android:text="旋转" />
    <CheckBox
        android:id="@+id/overlook"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:checked="true"
        android:onClick="setOverlookEnable"
        android:text="俯视" />
    <CheckBox
        android:id="@+id/zoomControl"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:checked="false"
        android:onClick="setBuiltInZoomControllEnable"
        android:text="缩放控件" />
  </LinearLayout>
  
  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:orientation="horizontal"
        android:layout_width="fill_parent"
        android:layout_height="50dip">
   
     <TextView 
         android:layout_width="wrap_content"  
         android:layout_height="wrap_content"  
         android:layout_weight="1"
         android:paddingTop="10dip"
         android:text="指南针位置"
     />
     <RadioGroup   
        android:id="@+id/RadioGroup"  
        android:layout_width="wrap_content"  
        android:layout_height="wrap_content"  
        android:layout_weight="1"
        android:orientation="horizontal"  
        android:text="指南针位置" 
     >   
       <RadioButton   
           android:id="@+id/lefttop"  
           android:layout_width="wrap_content"  
           android:layout_height="wrap_content"  
           android:onClick="setCompassLocation"
           android:checked="true"
           android:text="左上角"  
        />   
       <RadioButton   
           android:id="@+id/righttop"  
           android:layout_width="wrap_content"  
           android:layout_height="wrap_content"  
           android:onClick="setCompassLocation"
           android:text="右上角"  
        />   
    </RadioGroup>
    
  </LinearLayout>
    
  
    <com.baidu.mapapi.map.MapView android:id="@+id/bmapView"
	    android:layout_width="fill_parent" android:layout_height="wrap_content" 
	    android:clickable="true"     
	/>
    
</LinearLayout>

3.Activity具体功能实现:

package com.ztt.baidumap.ui;
 
import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.widget.CheckBox;
import android.widget.RadioButton;
 
import com.baidu.mapapi.BMapManager;
import com.baidu.mapapi.map.MapController;
import com.baidu.mapapi.map.MapView;
import com.baidu.platform.comapi.basestruct.GeoPoint;
 
/**
 * 演示地图UI控制功能
 */
public class UISettingDemo extends Activity {
 
	/**
	 *  MapView 是地图主控件
	 */
	private MapView mMapView = null;
	/**
	 *  用MapController完成地图控制 
	 */
	private MapController mMapController = null;
	
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        /**
         * 使用地图sdk前需先初始化BMapManager.
         * BMapManager是全局的，可为多个MapView共用，它需要地图模块创建前创建，
         * 并在地图地图模块销毁后销毁，只要还有地图模块在使用，BMapManager就不应该销毁
         */
        MyApplication app = (MyApplication)this.getApplication();
        if (app.mBMapManager == null) {
            app.mBMapManager = new BMapManager(getApplicationContext());
            /**
             * 如果BMapManager没有初始化则初始化BMapManager
             */
            app.mBMapManager.init(MyApplication.strKey,new MyApplication.MyGeneralListener());
        }
        /**
          * 由于MapView在setContentView()中初始化,所以它需要在BMapManager初始化之后
          */
        setContentView(R.layout.activity_uisetting);
        mMapView = (MapView)findViewById(R.id.bmapView);
        /**
         * 获取地图控制器
         */
        mMapController = mMapView.getController();
        /**
         *  设置地图是否响应点击事件  .
         */
        mMapController.enableClick(true);
        /**
         * 设置地图缩放级别
         */
        mMapController.setZoom(12);
        /**
         * 设置地图俯角
         */
        mMapController.setOverlooking(-30);
        /**
         * 将地图移动至天安门
         * 使用百度经纬度坐标，可以通过http://api.map.baidu.com/lbsapi/getpoint/index.html查询地理坐标
         * 如果需要在百度地图上显示使用其他坐标系统的位置，请发邮件至mapapi@baidu.com申请坐标转换接口
         */
        double cLat = 39.945 ;
        double cLon = 116.404 ;
        GeoPoint p = new GeoPoint((int)(cLat * 1E6), (int)(cLon * 1E6));
        mMapController.setCenter(p);
        
    }
    
    /**
     * 是否启用缩放手势
     * @param v
     */
    public void setZoomEnable(View v){
    	//缩放手势
    	mMapController.setZoomGesturesEnabled(((CheckBox) v).isChecked());
    }
    /**
     * 是否启用平移手势
     * @param v
     */
    public void setScrollEnable(View v){
    	//平移
    	mMapController.setScrollGesturesEnabled(((CheckBox) v).isChecked());
    }
    /**
     * 是否启用双击放大
     * @param v
     */
    public void setDoubleClickEnable(View v){
    	//双击
    	mMapView.setDoubleClickZooming(((CheckBox) v).isChecked());
    }
    /**
     * 是否启用旋转手势
     * @param v
     */
    public void setRotateEnable(View v){
    	//旋转
        mMapController.setRotationGesturesEnabled(((CheckBox) v).isChecked());    	
    }
    /**
     * 是否启用俯视手势
     * @param v
     */
    public void setOverlookEnable(View v){
    	//俯视
        mMapController.setOverlookingGesturesEnabled(((CheckBox) v).isChecked());    	
    }
    /**
     * 是否显示内置绽放控件
     * @param v
     */
    public void setBuiltInZoomControllEnable(View v){
    	//缩放控件
        mMapView.setBuiltInZoomControls(((CheckBox) v).isChecked());    	
    }
    
    /**
     * 设置指南针位置,指南针在3D模式下自动显现
     * @param view
     */
    public void setCompassLocation(View view){
        boolean checked = ((RadioButton) view).isChecked();
        switch(view.getId()) {
            case R.id.lefttop:
                if (checked)
                	//设置指南针显示在左上角
                	mMapController.setCompassMargin(100, 100);
                break;
            case R.id.righttop:
                if (checked)
                	mMapController.setCompassMargin(mMapView.getWidth() - 100, 100);
                break;
        }	
    }
    
    @Override
    protected void onPause() {
    	/**
    	 *  MapView的生命周期与Activity同步，当activity挂起时需调用MapView.onPause()
    	 */
        mMapView.onPause();
        super.onPause();
    }
    
    @Override
    protected void onResume() {
    	/**
    	 *  MapView的生命周期与Activity同步，当activity恢复时需调用MapView.onResume()
    	 */
        mMapView.onResume();
        super.onResume();
    }
    
    @Override
    protected void onDestroy() {
    	/**
    	 *  MapView的生命周期与Activity同步，当activity销毁时需调用MapView.destroy()
    	 */
        mMapView.destroy();
        super.onDestroy();
    }
    
    @Override
    protected void onSaveInstanceState(Bundle outState) {
    	super.onSaveInstanceState(outState);
    	mMapView.onSaveInstanceState(outState);
    	
    }
    
    @Override
    protected void onRestoreInstanceState(Bundle savedInstanceState) {
    	super.onRestoreInstanceState(savedInstanceState);
    	mMapView.onRestoreInstanceState(savedInstanceState);
    }
    
}