[012] 百度地图API之公交换乘方案搜索(Android)

      本文主要讲解如何通过百度地图API搜索得到两个地点之间的公交换乘方案信息，即从A点乘公交车到B点有哪些乘车方案可以选择。
      这是我写的第3篇介绍调用百度地图API搜索服务的文章，所以对搜索前要做的其它工作不再介绍，再加上代码中的注释也对相关的操作、方法做了尽可能详细的说明，所以直接看示例吧。
1）布局文件res/layout/main.xml
      

<?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"
    >
	<com.baidu.mapapi.MapView android:id="@+id/map_View"
		android:layout_width="fill_parent"
    	android:layout_height="fill_parent"
    	android:clickable="true"
    />
</LinearLayout>

 
2）继承了com.baidu.mapapi.MapActivity的Activity类
      

package com.liufeng.baidumap;

import android.os.Bundle;
import android.util.Log;

import com.baidu.mapapi.BMapManager;
import com.baidu.mapapi.GeoPoint;
import com.baidu.mapapi.MKAddrInfo;
import com.baidu.mapapi.MKDrivingRouteResult;
import com.baidu.mapapi.MKPlanNode;
import com.baidu.mapapi.MKPoiResult;
import com.baidu.mapapi.MKSearch;
import com.baidu.mapapi.MKSearchListener;
import com.baidu.mapapi.MKTransitRoutePlan;
import com.baidu.mapapi.MKTransitRouteResult;
import com.baidu.mapapi.MKWalkingRouteResult;
import com.baidu.mapapi.MapActivity;
import com.baidu.mapapi.MapController;
import com.baidu.mapapi.MapView;
import com.baidu.mapapi.TransitOverlay;

public class TransitPolicyActivity extends MapActivity {
	// 定义地图引擎管理类
	private BMapManager mapManager;
	// 定义搜索服务类
	private MKSearch mMKSearch;

	private MapView mapView;
	private MapController mapController;

	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.main);

		// 初始化MapActivity
		mapManager = new BMapManager(getApplication());
		// init方法的第一个参数需填入申请的API Key
		mapManager.init("285B415EBAB2A92293E85502150ADA7F03C777C4", null);
		super.initMapActivity(mapManager);

		mapView = (MapView) findViewById(R.id.map_View);
		// 设置地图模式为交通地图
		mapView.setTraffic(true);
		// 设置启用内置的缩放控件
		mapView.setBuiltInZoomControls(true);

		// 构造一个经纬度点（贵州大学）
		GeoPoint geoPoint = new GeoPoint((int) (26.449446 * 1E6), (int) (106.682949 * 1E6));

		// 取得地图控制器对象，用于控制MapView
		mapController = mapView.getController();
		// 设置地图的中心
		mapController.setCenter(geoPoint);
		// 设置地图默认的缩放级别
		mapController.setZoom(12);

		// 初始化MKSearch
		mMKSearch = new MKSearch();
		mMKSearch.init(mapManager, new MySearchListener());

		// 起点：贵州大学
		MKPlanNode startPlanNode = new MKPlanNode();
		startPlanNode.pt = new GeoPoint((int) (26.449446 * 1E6), (int) (106.682949 * 1E6));
		// 终点：贵州省移动
		MKPlanNode endPlanNode = new MKPlanNode();
		endPlanNode.pt = new GeoPoint((int) (26.601771 * 1E6), (int) (106.71968 * 1E6));
		/**
		 * 设置公交换乘路线搜索策略，有以下4种策略可选择：
		 *    1）不含地铁：MKSearch.EBUS_NO_SUBWAY
		 *    2）时间优先：MKSearch.EBUS_TIME_FIRST
		 *    3）最少换乘：MKSearch.EBUS_TRANSFER_FIRST 
		 *    4）最少步行距离：MKSearch.EBUS_WALK_FIRST
		 *    
		 * 我们这里选择的搜索策略是最少换乘，即中途转车次数最少
		 */
		mMKSearch.setTransitPolicy(MKSearch.EBUS_TRANSFER_FIRST);
		// 要设置在哪个城市搜索
		mMKSearch.transitSearch("贵阳", startPlanNode, endPlanNode);
	}

	@Override
	protected boolean isRouteDisplayed() {
		return false;
	}

	@Override
	protected void onDestroy() {
		if (mapManager != null) {
			// 程序退出前需调用此方法
			mapManager.destroy();
			mapManager = null;
		}
		super.onDestroy();
	}

	@Override
	protected void onPause() {
		if (mapManager != null) {
			// 终止百度地图API
			mapManager.stop();
		}
		super.onPause();
	}

	@Override
	protected void onResume() {
		if (mapManager != null) {
			// 开启百度地图API
			mapManager.start();
		}
		super.onResume();
	}

	/**
	 * 实现MKSearchListener接口,用于实现异步搜索服务
	 * 
	 * @author liufeng
	 */
	public class MySearchListener implements MKSearchListener {
		/**
		 * 根据经纬度搜索地址信息结果
		 * 
		 * @param result 搜索结果
		 * @param iError 错误号（0表示正确返回）
		 */
		@Override
		public void onGetAddrResult(MKAddrInfo result, int iError) {
		}

		/**
		 * 驾车路线搜索结果
		 * 
		 * @param result 搜索结果
		 * @param iError 错误号（0表示正确返回）
		 */
		@Override
		public void onGetDrivingRouteResult(MKDrivingRouteResult result, int iError) {
		}

		/**
		 * POI搜索结果（范围检索、城市POI检索、周边检索）
		 * 
		 * @param result 搜索结果
		 * @param type 返回结果类型（11,12,21:poi列表 7:城市列表）
		 * @param iError 错误号（0表示正确返回）
		 */
		@Override
		public void onGetPoiResult(MKPoiResult result, int type, int iError) {
		}

		/**
		 * 公交换乘路线搜索结果
		 * 
		 * @param result 搜索结果
		 * @param iError 错误号（0表示正确返回）
		 */
		@Override
		public void onGetTransitRouteResult(MKTransitRouteResult result, int iError) {
			if (result == null) {
				return;
			}
			Log.d("liuyq", "公交换乘方案数：" + result.getNumPlan());

			// TransitOverlay是baidu map api提供的用于在地图上显示公交换乘路线的Overlay
			TransitOverlay transitOverlay = new TransitOverlay(TransitPolicyActivity.this, mapView);
			// 展示其中一个换乘方案
			transitOverlay.setData(result.getPlan(0));
			// 在地图上显示
			mapView.getOverlays().add(transitOverlay);
			
			/**
			 * 如果需要在地图上展示所有公交换乘方案，请将165-170行注释，并打开注释行176-186
			 * 但由于通常返回的公交换乘方案数较多，全显示在地图上会很乱，可能分辨不出来,所以只显示了其中一种方案
			 */
			/**
			TransitOverlay transitOverlay = null;
			// 遍历搜索结果，得到所有换乘方案
			for(int i=0; i<result.getNumPlan(); i++) {
				transitOverlay = new TransitOverlay(TransitPolicyActivity.this, mapView);
				// 设置展示数据
				transitOverlay.setData(result.getPlan(i));
				// 在地图上显示
				mapView.getOverlays().add(transitOverlay);
			}
			*/
			
			/**
			 * 说明：
			 * 		1）公交换乘路线搜索结果通常都有多种换乘方案;
			 * 		2）通过result.getNumPlan()可以得到换乘方案数。
			 * 除了在地图上标注其中一种公交换乘方案外，如果我们要得到所有换乘方案的信息，就需要像下面这样遍历搜索结果
			 */
			
			// 遍历搜索结果，得到所有换乘方案
			for(int i=0; i<result.getNumPlan(); i++) {
				// 公交换乘方案详情类
				MKTransitRoutePlan routePlan = result.getPlan(i);
				// 再根据MKTransitRoutePlan类提供的方法去获取具体的换乘信息（省略）
			}
		}

		/**
		 * 步行路线搜索结果
		 * 
		 * @param result 搜索结果
		 * @param iError 错误号（0表示正确返回）
		 */
		@Override
		public void onGetWalkingRouteResult(MKWalkingRouteResult result, int iError) {
		}
	}
}

  
说明：在上面代码中的199行，省略了根据MKTransitRoutePlan类提供的方法去获取具体的换乘信息。其实根据百度官方网站上提供的API文档，一步步去实现它应该不太难。 （省略部分我也没有具体去实现它，并不是不公开）
      下面是MKTransitRoutePlan类所提示的部分方法，可以参考下。
     
3）AndroidManifest.xml中的配置
      

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="com.liufeng.baidumap"
      android:versionCode="1"
      android:versionName="1.0">
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <activity android:name=".TransitPolicyActivity" android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
    <uses-sdk android:minSdkVersion="4" />

    <!-- 访问网络的权限 -->
    <uses-permission android:name="android.permission.INTERNET" />
	<!-- 访问精确位置的权限 -->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <!-- 访问网络状态的权限 -->
	<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <!-- 访问WIFI网络状态的权限 -->
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <!-- 改变WIFI网络状态的权限 -->
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <!-- 读写存储卡的权限 -->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <!-- 读取电话状态的权限 -->
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
</manifest>

  
4）运行结果
      
可以看到，从“贵州大学”到“贵州省移动”的其中一条公交换乘方案已经显示在地图上了，点击标注线路上的起点、换乘点、终点都会有相乘车（有些地方公交无法到达，例如校园内，会采用步行+公交的方式）信息说明。

备注：这几篇文章所讲解的百度地图API搜索服务都有一个共同点，那就是调用所有的搜索服务都需要传入地理坐标参数（经纬度）。就拿本例来说，就必须事先知道“贵州大学”和“贵州省移动”两个地点的地理坐标（经纬度）才能进行公交线路查询。在实际应用中，肯定是提供两个输入框，由用户来输入起点和终点，当然用户输入的肯定是中文地址信息，而不是经纬度。所以如何根据地理位置来获取经纬度值，这将是我们后面要学习研究的内容。