【百度地图开发之四】百度地图基本操作功能实现讲解

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

上一篇我们学习了【百度地图开发之三】百度地图UI控制功能讲解(点击跳转),今天继续看一下百度地图一些基本的操作功能的实现;

(一)基本介绍:

     百度地图的一些基本操作控制包括地图的缩放,旋转,俯视,单双击,长按等控制事件,实现前面的三个功能主要需要用到MapController类,单双击,长按事件需要用到MapView的监听事件处理接口MKMapTouchListener

(二)控制类,接口基本介绍

     1:MapController:地图操作控制器,今天我们主要用到了其中的以下方法:

        ①:public float setZoom(float zoomLevel):设置地图的缩放级别,这个值的取值范围为[3,19];

        ②:public void setRotation(int rotate):设置地图的旋转角度

        ③:public void setOverlooking(int voidlook):设置地图的俯视角度

    2:MKMapTouchListener:地图点击事件监听器接口,主要有以下方法:

        ①:void onMapClick(GeoPoint point):地图单击事件,回调回来回来点击的地图的坐标点位置.

        ②:void onMapDoubleClick(GeoPoint point):地图双击事件,回调双击的地图的坐标点位置.

        ③:void onMapLongClick(GeoPoint point):地图的长按事件,回调长按的地图的坐标点位置.

(三):事件监听器使用方法:

       我们只要在MapView对象中注册MKMapTouchListener监听器,并且实现其中的单击,双击,长按事件方法即可.具体实现方法如下:

/**
         * 设置地图点击事件监听 
         */
        mapTouchListener = new MKMapTouchListener(){
			@Override
			public void onMapClick(GeoPoint point) {
				touchType = "单击";
				currentPt = point;
				updateMapState();
				
			}

			@Override
			public void onMapDoubleClick(GeoPoint point) {
				touchType = "双击";
				currentPt = point;
				updateMapState();
			}

			@Override
			public void onMapLongClick(GeoPoint point) {
				touchType = "长按";
				currentPt = point;
				updateMapState();
			}
        };
        //给地图注册事件
        mMapView.regMapTouchListner(mapTouchListener);

(四)下面我们来看下百度地图SDK中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 
    android:orientation="horizontal"
    android:layout_width="fill_parent"
    android:layout_height="50dip">
    
    <Button
        android:id="@+id/zoombutton"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:background="@drawable/button_style"
        android:text="缩放" />

    <EditText
        android:id="@+id/zoomlevel"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="10" />

    <Button
        android:id="@+id/rotatebutton"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:background="@drawable/button_style"
        android:text="旋转" />

    <EditText
        android:id="@+id/rotateangle"
    	android:text="90"
    	android:layout_width="fill_parent"
    	android:layout_height="wrap_content"
    	android:layout_weight="1"
        />

    <Button
        android:id="@+id/overlookbutton"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
    	android:layout_weight="1"
        android:background="@drawable/button_style"
        android:text="俯视" />

    <EditText
        android:id="@+id/overlookangle"
    	android:text="-30"
    	android:layout_width="fill_parent"
    	android:layout_height="wrap_content"
    	android:layout_weight="1"
        />
    </LinearLayout>
    <TextView
        android:id="@+id/state"
    	android:text="点击、长按、双击地图以获取经纬度和地图状态"
    	android:layout_width="fill_parent"
    	android:layout_height="wrap_content"
    	android:lines="3"
        />
    <RelativeLayout 
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
  <com.baidu.mapapi.map.MapView android:id="@+id/bmapView"
	    android:layout_width="fill_parent" android:layout_height="fill_parent" 
	    android:clickable="true"     
	/>
    <Button
        android:id="@+id/savescreen"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentTop="true"
        android:layout_alignParentRight="true"
        android:layout_marginTop="10dip"
        android:background="@drawable/button_style"
        android:text="截图" />

</RelativeLayout>

  </LinearLayout>

    3:功能实现Activity代码:


package com.ztt.baidumap.ui;

import java.io.File;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;

import android.app.Activity;
import android.graphics.Bitmap;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;
import android.widget.Toast;

import com.baidu.mapapi.BMapManager;
import com.baidu.mapapi.map.MKMapTouchListener;
import com.baidu.mapapi.map.MKMapViewListener;
import com.baidu.mapapi.map.MapController;
import com.baidu.mapapi.map.MapPoi;
import com.baidu.mapapi.map.MapView;
import com.baidu.platform.comapi.basestruct.GeoPoint;

/**
 * 演示地图缩放,旋转,视角控制
 */
public class MapControlDemo extends Activity {

	/**
	 *  MapView 是地图主控件
	 */
	private MapView mMapView = null;
	/**
	 *  用MapController完成地图控制 
	 */
	private MapController mMapController = null;
	/**
	 *  MKMapViewListener 用于处理地图事件回调
	 */
	MKMapViewListener mMapListener = null;
	/**
	 * 用于截获屏坐标
	 */
	MKMapTouchListener mapTouchListener = null; 
	/**
	 * 当前地点击点
	 */
	private GeoPoint currentPt = null; 
	/**
	 * 控制按钮
	 */
	private Button zoomButton = null;  //缩放
	private Button rotateButton = null; //旋转
	private Button overlookButton =null;  //俯视
	private Button saveScreenButton = null;  //截图
	/**
	 * 
	 */
	private String touchType = null;
	/**
	 * 用于显示地图状态的面板
	 */
	private TextView mStateBar = 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_mapcontrol);
        mMapView = (MapView)findViewById(R.id.bmapView);
        /**
         * 获取地图控制器
         */
        mMapController = mMapView.getController();
        /**
         *  设置地图是否响应点击事件  .
         */
        mMapController.enableClick(true);
        /**
         * 设置地图缩放级别
         */
        mMapController.setZoom(12);
        
        mStateBar = (TextView) findViewById(R.id.state);
        /**
         * 初始化地图事件监听
         */
        initListener();
       
        /**
         * 将地图移动至天安门
         * 使用百度经纬度坐标,可以通过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);
        
    }
    
    /**
     * 添加监听事件
     */
    private void initListener() {
    	/**
         * 设置地图点击事件监听 
         */
        mapTouchListener = new MKMapTouchListener(){
			@Override
			public void onMapClick(GeoPoint point) {
				touchType = "单击";
				currentPt = point;
				updateMapState();
				
			}

			@Override
			public void onMapDoubleClick(GeoPoint point) {
				touchType = "双击";
				currentPt = point;
				updateMapState();
			}

			@Override
			public void onMapLongClick(GeoPoint point) {
				touchType = "长按";
				currentPt = point;
				updateMapState();
			}
        };
        //给地图注册事件
        mMapView.regMapTouchListner(mapTouchListener);
        /**
         * 设置地图事件监听
         */
        mMapListener = new MKMapViewListener() {
			@Override
			public void onMapMoveFinish() {
				/**
				 * 在此处理地图移动完成回调
				 * 缩放,平移等操作完成后,此回调被触发
				 */
				updateMapState();
			}
			
			@Override
			public void onClickMapPoi(MapPoi mapPoiInfo) {
				/**
				 * 在此处理底图poi点击事件
				 * 显示底图poi名称并移动至该点
				 * 设置过: mMapController.enableClick(true); 时,此回调才能被触发
				 * 
				 */
				
			}

			@Override
			public void onGetCurrentMap(Bitmap b) {
				/**
				 *  当调用过 mMapView.getCurrentMap()后,此回调会被触发
				 *  可在此保存截图至存储设备
				 */
				File file = new File("/mnt/sdcard/test.png");
                FileOutputStream out;
                try{
                    out = new FileOutputStream(file);
                    if(b.compress(Bitmap.CompressFormat.PNG, 70, out)) 
                    {
                        out.flush();
                        out.close();
                    }
                    Toast.makeText(MapControlDemo.this, 
                    	    "屏幕截图成功,图片存在: "+file.toString(),	
                    		 Toast.LENGTH_SHORT)
                         .show();
                } 
                catch (FileNotFoundException e) 
                {
                    e.printStackTrace();
                } 
                catch (IOException e) 
                {
                    e.printStackTrace(); 
                }
                
			}

			@Override
			public void onMapAnimationFinish() {
				/**
				 *  地图完成带动画的操作(如: animationTo())后,此回调被触发
				 */
				updateMapState();
			}

			@Override
			public void onMapLoadFinish() {
				// TODO Auto-generated method stub
				
			}
		};
		mMapView.regMapViewListener(MyApplication.getInstance().mBMapManager, mMapListener);
		/**
		 * 设置按键监听
		 */
		zoomButton        = (Button)findViewById(R.id.zoombutton);
		rotateButton      = (Button)findViewById(R.id.rotatebutton);
		overlookButton    = (Button)findViewById(R.id.overlookbutton);
		saveScreenButton  = (Button)findViewById(R.id.savescreen);
		OnClickListener onClickListener = new OnClickListener(){
			@Override
			public void onClick(View view) {
				if ( view.equals(zoomButton)){
					perfomZoom();
				}
				else if( view.equals(rotateButton)){
					perfomRotate();
				}
				else if( view.equals(overlookButton)){
					perfomOverlook();
				}
				else if ( view.equals(saveScreenButton)){
					//截图,在MKMapViewListener中保存图片
				     mMapView.getCurrentMap();	
				     Toast.makeText(MapControlDemo.this, 
				    		 "正在截取屏幕图片...", 
				    		 Toast.LENGTH_SHORT ).show();
				          
				}
				updateMapState();
			}
			
		};
		zoomButton.setOnClickListener(onClickListener);
		rotateButton.setOnClickListener(onClickListener);
		overlookButton.setOnClickListener(onClickListener);
		saveScreenButton.setOnClickListener(onClickListener);
    }
    /**
     * 处理缩放
     * sdk 缩放级别范围: [3.0,19.0]
     */
    private void perfomZoom(){
    	EditText  t  = (EditText) findViewById(R.id.zoomlevel);
    	try{
    	    float zoomLevel = Float.parseFloat(t.getText().toString());
    	    //设置地图缩放级别
    	    mMapController.setZoom(zoomLevel);
    	}catch(NumberFormatException e){
    		Toast.makeText(this, 
    	         "请输入正确的缩放级别", Toast.LENGTH_SHORT)
    		     .show();
    	}
    }
    /**
     * 处理旋转 
     * 旋转角范围: -180 ~ 180 , 单位:度   逆时针旋转  
     */
    private void perfomRotate(){
    	EditText  t  = (EditText) findViewById(R.id.rotateangle);
    	try{
    	    int rotateAngle = Integer.parseInt(t.getText().toString());
    	    //设置地图旋转角度
    	    mMapController.setRotation(rotateAngle);
    	}catch(NumberFormatException e){
    		Toast.makeText(this, 
    	         "请输入正确的旋转角度", Toast.LENGTH_SHORT)
    		     .show();
    	}
    }
    /**
     * 处理俯视
     * 俯角范围:  -45 ~ 0 , 单位: 度
     */
    private void perfomOverlook(){
    	EditText  t  = (EditText) findViewById(R.id.overlookangle);
    	try{
    	    int overlookAngle = Integer.parseInt(t.getText().toString());
    	    //设置地图的俯视
    	    mMapController.setOverlooking(overlookAngle);
    	}catch(NumberFormatException e){
    		Toast.makeText(this, 
    	         "请输入正确的俯角", Toast.LENGTH_SHORT)
    		     .show();
    	}	
    }
    
    /**
     * 更新地图状态显示面板
     */
    private void updateMapState(){
    	   if ( mStateBar == null){
    		   return ;
    	   }
    		String state  = "";
    		if ( currentPt == null ){
    			state = "点击、长按、双击地图以获取经纬度和地图状态";
    		}
    		else{
    			state = String.format(touchType+",当前经度 : %f 当前纬度:%f",currentPt.getLongitudeE6()*1E-6,currentPt.getLatitudeE6()*1E-6);
    		}
    		state += "\n";
    		state += String.format("zoom level= %.1f    rotate angle= %d   overlaylook angle=  %d",
                mMapView.getZoomLevel(), 
                mMapView.getMapRotation(),
                mMapView.getMapOverlooking() 
    	    );
    		mStateBar.setText(state);
    }
    
    @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);
    }
    
}

  4:运行截图:




[注明]AndroidManifest.xml的配置和之前的文章中一样.