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