[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;@Overridepublic void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.main);// 初始化MapActivitymapManager = new BMapManager(getApplication());// init方法的第一个参数需填入申请的API KeymapManager.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));// 取得地图控制器对象，用于控制MapViewmapController = mapView.getController();// 设置地图的中心mapController.setCenter(geoPoint);// 设置地图默认的缩放级别mapController.setZoom(12);// 初始化MKSearchmMKSearch = 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);}@Overrideprotected boolean isRouteDisplayed() {return false;}@Overrideprotected void onDestroy() {if (mapManager != null) {// 程序退出前需调用此方法mapManager.destroy();mapManager = null;}super.onDestroy();}@Overrideprotected void onPause() {if (mapManager != null) {// 终止百度地图APImapManager.stop();}super.onPause();}@Overrideprotected void onResume() {if (mapManager != null) {// 开启百度地图APImapManager.start();}super.onResume();}/** * 实现MKSearchListener接口,用于实现异步搜索服务 * * @author liufeng */public class MySearchListener implements MKSearchListener {/** * 根据经纬度搜索地址信息结果 * * @param result 搜索结果 * @param iError 错误号（0表示正确返回） */@Overridepublic void onGetAddrResult(MKAddrInfo result, int iError) {}/** * 驾车路线搜索结果 * * @param result 搜索结果 * @param iError 错误号（0表示正确返回） */@Overridepublic void onGetDrivingRouteResult(MKDrivingRouteResult result, int iError) {}/** * POI搜索结果（范围检索、城市POI检索、周边检索） * * @param result 搜索结果 * @param type 返回结果类型（11,12,21:poi列表 7:城市列表） * @param iError 错误号（0表示正确返回） */@Overridepublic void onGetPoiResult(MKPoiResult result, int type, int iError) {}/** * 公交换乘路线搜索结果 * * @param result 搜索结果 * @param iError 错误号（0表示正确返回） */@Overridepublic void onGetTransitRouteResult(MKTransitRouteResult result, int iError) {if (result == null) {return;}Log.d("liuyq", "公交换乘方案数：" + result.getNumPlan());// TransitOverlay是baidu map api提供的用于在地图上显示公交换乘路线的OverlayTransitOverlay 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表示正确返回） */@Overridepublic 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搜索服务都有一个共同点，那就是调用所有的搜索服务都需要传入地理坐标参数（经纬度）。就拿本例来说，就必须事先知道“贵州大学”和“贵州省移动”两个地点的地理坐标（经纬度）才能进行公交线路查询。在实际应用中，肯定是提供两个输入框，由用户来输入起点和终点，当然用户输入的肯定是中文地址信息，而不是经纬度。所以如何根据地理位置来获取经纬度值，这将是我们后面要学习研究的内容。