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

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

[xhtml] view plain copy print ?

1. <?xml version="1.0" encoding="utf-8"?>  
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
3.     android:orientation="vertical"  
4.     android:layout_width="fill_parent"  
5.     android:layout_height="fill_parent"  
6.     >  
7.     <com.baidu.mapapi.MapView android:id="@+id/map_View"  
8.         android:layout_width="fill_parent"  
9.         android:layout_height="fill_parent"  
10.         android:clickable="true"  
11.     />  
12. </LinearLayout>  

<?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类
      

[java] view plain copy print ?

1. package com.liufeng.baidumap;  
2.   
3. import android.os.Bundle;  
4. import android.util.Log;  
5.   
6. import com.baidu.mapapi.BMapManager;  
7. import com.baidu.mapapi.GeoPoint;  
8. import com.baidu.mapapi.MKAddrInfo;  
9. import com.baidu.mapapi.MKDrivingRouteResult;  
10. import com.baidu.mapapi.MKPlanNode;  
11. import com.baidu.mapapi.MKPoiResult;  
12. import com.baidu.mapapi.MKSearch;  
13. import com.baidu.mapapi.MKSearchListener;  
14. import com.baidu.mapapi.MKTransitRoutePlan;  
15. import com.baidu.mapapi.MKTransitRouteResult;  
16. import com.baidu.mapapi.MKWalkingRouteResult;  
17. import com.baidu.mapapi.MapActivity;  
18. import com.baidu.mapapi.MapController;  
19. import com.baidu.mapapi.MapView;  
20. import com.baidu.mapapi.TransitOverlay;  
21.   
22. public class TransitPolicyActivity extends MapActivity {  
23.     // 定义地图引擎管理类   
24.     private BMapManager mapManager;  
25.     // 定义搜索服务类   
26.     private MKSearch mMKSearch;  
27.   
28.     private MapView mapView;  
29.     private MapController mapController;  
30.   
31.     @Override  
32.     public void onCreate(Bundle savedInstanceState) {  
33.         super.onCreate(savedInstanceState);  
34.         setContentView(R.layout.main);  
35.   
36.         // 初始化MapActivity   
37.         mapManager = new BMapManager(getApplication());  
38.         // init方法的第一个参数需填入申请的API Key   
39.         mapManager.init("285B415EBAB2A92293E85502150ADA7F03C777C4", null);  
40.         super.initMapActivity(mapManager);  
41.   
42.         mapView = (MapView) findViewById(R.id.map_View);  
43.         // 设置地图模式为交通地图   
44.         mapView.setTraffic(true);  
45.         // 设置启用内置的缩放控件   
46.         mapView.setBuiltInZoomControls(true);  
47.   
48.         // 构造一个经纬度点（贵州大学）   
49.         GeoPoint geoPoint = new GeoPoint((int) (26.449446 * 1E6), (int) (106.682949 * 1E6));  
50.   
51.         // 取得地图控制器对象，用于控制MapView   
52.         mapController = mapView.getController();  
53.         // 设置地图的中心   
54.         mapController.setCenter(geoPoint);  
55.         // 设置地图默认的缩放级别   
56.         mapController.setZoom(12);  
57.   
58.         // 初始化MKSearch   
59.         mMKSearch = new MKSearch();  
60.         mMKSearch.init(mapManager, new MySearchListener());  
61.   
62.         // 起点：贵州大学   
63.         MKPlanNode startPlanNode = new MKPlanNode();  
64.         startPlanNode.pt = new GeoPoint((int) (26.449446 * 1E6), (int) (106.682949 * 1E6));  
65.         // 终点：贵州省移动   
66.         MKPlanNode endPlanNode = new MKPlanNode();  
67.         endPlanNode.pt = new GeoPoint((int) (26.601771 * 1E6), (int) (106.71968 * 1E6));  
68.         /** 
69.          * 设置公交换乘路线搜索策略，有以下4种策略可选择： 
70.          *    1）不含地铁：MKSearch.EBUS_NO_SUBWAY 
71.          *    2）时间优先：MKSearch.EBUS_TIME_FIRST 
72.          *    3）最少换乘：MKSearch.EBUS_TRANSFER_FIRST  
73.          *    4）最少步行距离：MKSearch.EBUS_WALK_FIRST 
74.          *     
75.          * 我们这里选择的搜索策略是最少换乘，即中途转车次数最少 
76.          */  
77.         mMKSearch.setTransitPolicy(MKSearch.EBUS_TRANSFER_FIRST);  
78.         // 要设置在哪个城市搜索   
79.         mMKSearch.transitSearch("贵阳", startPlanNode, endPlanNode);  
80.     }  
81.   
82.     @Override  
83.     protected boolean isRouteDisplayed() {  
84.         return false;  
85.     }  
86.   
87.     @Override  
88.     protected void onDestroy() {  
89.         if (mapManager != null) {  
90.             // 程序退出前需调用此方法   
91.             mapManager.destroy();  
92.             mapManager = null;  
93.         }  
94.         super.onDestroy();  
95.     }  
96.   
97.     @Override  
98.     protected void onPause() {  
99.         if (mapManager != null) {  
100.             // 终止百度地图API   
101.             mapManager.stop();  
102.         }  
103.         super.onPause();  
104.     }  
105.   
106.     @Override  
107.     protected void onResume() {  
108.         if (mapManager != null) {  
109.             // 开启百度地图API   
110.             mapManager.start();  
111.         }  
112.         super.onResume();  
113.     }  
114.   
115.     /** 
116.      * 实现MKSearchListener接口,用于实现异步搜索服务 
117.      *  
118.      * @author liufeng 
119.      */  
120.     public class MySearchListener implements MKSearchListener {  
121.         /** 
122.          * 根据经纬度搜索地址信息结果 
123.          *  
124.          * @param result 搜索结果 
125.          * @param iError 错误号（0表示正确返回） 
126.          */  
127.         @Override  
128.         public void onGetAddrResult(MKAddrInfo result, int iError) {  
129.         }  
130.   
131.         /** 
132.          * 驾车路线搜索结果 
133.          *  
134.          * @param result 搜索结果 
135.          * @param iError 错误号（0表示正确返回） 
136.          */  
137.         @Override  
138.         public void onGetDrivingRouteResult(MKDrivingRouteResult result, int iError) {  
139.         }  
140.   
141.         /** 
142.          * POI搜索结果（范围检索、城市POI检索、周边检索） 
143.          *  
144.          * @param result 搜索结果 
145.          * @param type 返回结果类型（11,12,21:poi列表 7:城市列表） 
146.          * @param iError 错误号（0表示正确返回） 
147.          */  
148.         @Override  
149.         public void onGetPoiResult(MKPoiResult result, int type, int iError) {  
150.         }  
151.   
152.         /** 
153.          * 公交换乘路线搜索结果 
154.          *  
155.          * @param result 搜索结果 
156.          * @param iError 错误号（0表示正确返回） 
157.          */  
158.         @Override  
159.         public void onGetTransitRouteResult(MKTransitRouteResult result, int iError) {  
160.             if (result == null) {  
161.                 return;  
162.             }  
163.             Log.d("liuyq", "公交换乘方案数：" + result.getNumPlan());  
164.   
165.             // TransitOverlay是baidu map api提供的用于在地图上显示公交换乘路线的Overlay   
166.             TransitOverlay transitOverlay = new TransitOverlay(TransitPolicyActivity.this, mapView);  
167.             // 展示其中一个换乘方案   
168.             transitOverlay.setData(result.getPlan(0));  
169.             // 在地图上显示   
170.             mapView.getOverlays().add(transitOverlay);  
171.               
172.             /** 
173.              * 如果需要在地图上展示所有公交换乘方案，请将165-170行注释，并打开注释行176-186 
174.              * 但由于通常返回的公交换乘方案数较多，全显示在地图上会很乱，可能分辨不出来,所以只显示了其中一种方案 
175.              */  
176.             /** 
177.             TransitOverlay transitOverlay = null; 
178.             // 遍历搜索结果，得到所有换乘方案 
179.             for(int i=0; i<result.getNumPlan(); i++) { 
180.                 transitOverlay = new TransitOverlay(TransitPolicyActivity.this, mapView); 
181.                 // 设置展示数据 
182.                 transitOverlay.setData(result.getPlan(i)); 
183.                 // 在地图上显示 
184.                 mapView.getOverlays().add(transitOverlay); 
185.             } 
186.             */  
187.               
188.             /** 
189.              * 说明： 
190.              *      1）公交换乘路线搜索结果通常都有多种换乘方案; 
191.              *      2）通过result.getNumPlan()可以得到换乘方案数。 
192.              * 除了在地图上标注其中一种公交换乘方案外，如果我们要得到所有换乘方案的信息，就需要像下面这样遍历搜索结果 
193.              */  
194.               
195.             // 遍历搜索结果，得到所有换乘方案   
196.             for(int i=0; i<result.getNumPlan(); i++) {  
197.                 // 公交换乘方案详情类   
198.                 MKTransitRoutePlan routePlan = result.getPlan(i);  
199.                 // 再根据MKTransitRoutePlan类提供的方法去获取具体的换乘信息（省略）   
200.             }  
201.         }  
202.   
203.         /** 
204.          * 步行路线搜索结果 
205.          *  
206.          * @param result 搜索结果 
207.          * @param iError 错误号（0表示正确返回） 
208.          */  
209.         @Override  
210.         public void onGetWalkingRouteResult(MKWalkingRouteResult result, int iError) {  
211.         }  
212.     }  
213. }  

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中的配置
      

[xhtml] view plain copy print ?

1. <?xml version="1.0" encoding="utf-8"?>  
2. <manifest xmlns:android="http://schemas.android.com/apk/res/android"  
3.       package="com.liufeng.baidumap"  
4.       android:versionCode="1"  
5.       android:versionName="1.0">  
6.     <application android:icon="@drawable/icon" android:label="@string/app_name">  
7.         <activity android:name=".TransitPolicyActivity" android:label="@string/app_name">  
8.             <intent-filter>  
9.                 <action android:name="android.intent.action.MAIN" />  
10.                 <category android:name="android.intent.category.LAUNCHER" />  
11.             </intent-filter>  
12.         </activity>  
13.     </application>  
14.     <uses-sdk android:minSdkVersion="4" />  
15.   
16.     <!-- 访问网络的权限 -->  
17.     <uses-permission android:name="android.permission.INTERNET" />  
18.     <!-- 访问精确位置的权限 -->  
19.     <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />  
20.     <!-- 访问网络状态的权限 -->  
21.     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
22.     <!-- 访问WIFI网络状态的权限 -->  
23.     <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />  
24.     <!-- 改变WIFI网络状态的权限 -->  
25.     <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />  
26.     <!-- 读写存储卡的权限 -->  
27.     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />  
28.     <!-- 读取电话状态的权限 -->  
29.     <uses-permission android:name="android.permission.READ_PHONE_STATE" />  
30. </manifest>   

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