写在前面：
出去玩免不了挤公交、等地铁，不知道乘车方案当然不行，用官方APP吧，缺点一大堆，手机浏览器在线查的话既慢又麻烦...为了解决这些问题，我们来做一个简版的出行助手，嘛嘛再也不用担心我会迷路了_\^o^/_
（一）功能需求分析
[基础功能]
1.能够根据起点站和终点站查询乘车方案，并显示多种乘车方案
2.能够根据公交路线号查询沿途站点（防止坐过站...）
[扩展功能]
3.GPS定位获取起点站（距离当前位置最近的站点名）[后来放弃了，费电，费流量...]
4.显示地图[后来也放弃了，地图对用户来说好像没什么太大用处（当然喜欢走路的另当别论），至少对本人来说地图没什么用]
（二）可实现性分析
1.百度地图开放平台提供的API可以实现乘车方案查询
2.3.4.同上，结论：完全可以实现需要的所有功能
（三）开发前提
1.需要BaiDuMap的开发者账号
2.需要key（现在新版的地图key与App唯一绑定）
3.需要官方提供的jar包
搜索一下“百度地图开发”，上面的三件事情分分钟搞定
[说到这里不得不赞一下这极低的门槛了，腾讯、新浪微博...的开发者账号就很难认证，有的甚至需要上传身份证复印件...]
（四）研究API文档以及Demo
API文档说实话做得不怎么样，函数详解都只有一句话，建议直接看Demo，附有大量注释，简单易懂
（五）开始编码（下面给出的源码都亲测可用，并附有最详细的注释）
[SearchPlan.java---MainActivity]
package com.ayqy.app_gowithme; import java.util.ArrayList; import android.app.Activity;
import android.app.AlertDialog.Builder;
import android.content.DialogInterface;
import android.content.Intent;
import android.os.Bundle;
import android.text.InputType;
import android.view.Menu;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.ArrayAdapter;
import android.widget.Button;
import android.widget.EditText;
import android.widget.LinearLayout;
import android.widget.ListView;
import android.widget.TextView;
import android.widget.Toast; import com.baidu.mapapi.BMapManager;
import com.baidu.mapapi.search.MKAddrInfo;
import com.baidu.mapapi.search.MKBusLineResult;
import com.baidu.mapapi.search.MKDrivingRouteResult;
import com.baidu.mapapi.search.MKLine;
import com.baidu.mapapi.search.MKPlanNode;
import com.baidu.mapapi.search.MKPoiInfo;
import com.baidu.mapapi.search.MKPoiResult;
import com.baidu.mapapi.search.MKRoute;
import com.baidu.mapapi.search.MKSearch;
import com.baidu.mapapi.search.MKSearchListener;
import com.baidu.mapapi.search.MKShareUrlResult;
import com.baidu.mapapi.search.MKSuggestionResult;
import com.baidu.mapapi.search.MKTransitRoutePlan;
import com.baidu.mapapi.search.MKTransitRouteResult;
import com.baidu.mapapi.search.MKWalkingRouteResult; public class SearchPlan extends Activity{ BMapManager mBMapMan = null; ListView list;
private MKSearch mSearch = null; // 搜索模块，也可去掉地图模块独立使用
private String city;//城市
private String start;//起点
private String end;//终点
EditText txtCity;
EditText txtStart;
EditText txtEnd;
Button btnSearch; ArrayList<String> plans;//方案列表
ArrayList<String> details;//详细方案 @Override
protected void onCreate(Bundle savedInstanceState) {
// TODO Auto-generated method stub
super.onCreate(savedInstanceState);
//获取SDK使用权限
mBMapMan=new BMapManager(getApplication());
mBMapMan.init("MzKbxcvX7gBEqpeW2kdmOqhx", null);
//注意：上面方法的第一个参数必须要填自己申请的key
//因为App的PackageName--Shell值--key都唯一对应
//用别人的key肯定会出现授权失败的错误，结果就是什么API都别想用 this.setContentView(R.layout.query); //关联控件
list = (ListView) findViewById(R.id.List);
txtCity = (EditText) findViewById(R.id.txtCity);
txtStart = (EditText) findViewById(R.id.txtStart);
txtEnd = (EditText) findViewById(R.id.txtEnd);
btnSearch = (Button) findViewById(R.id.btnSearch);
//设置按钮半透明
btnSearch.getBackground().setAlpha(204);
//
txtStart.setText("小居安");
// btnSearch.setOnClickListener(new OnClickListener() { @Override
public void onClick(View v) {
//搜索乘车方案
//判空
start = txtStart.getText().toString().trim();
end = txtEnd.getText().toString().trim();
city = txtCity.getText().toString().trim();
if("".equals(start) || "".equals(end) || "".equals(city))
{
Toast.makeText(SearchPlan.this, "...到底想去哪里", Toast.LENGTH_SHORT).show();
return;
}
else
{
//搜索方案
searchPlans();
}
}
}); // 初始化搜索模块，注册事件监听
mSearch = new MKSearch();
mSearch.init(mBMapMan, new MKSearchListener() { @Override
public void onGetPoiDetailSearchResult(int type, int error) {
} public void onGetDrivingRouteResult(MKDrivingRouteResult res,
int error) {
} public void onGetTransitRouteResult(MKTransitRouteResult res,
int error) { if (error != 0 || res == null) {
showError(error);
return;
} // 得到解决方案
int maxPlanNum = res.getNumPlan();//方案数
//显示方案列表
plans = new ArrayList<String>();
details = new ArrayList<String>();
for(int i = 0;i < maxPlanNum;i++)
{
//得到详细方案
MKTransitRoutePlan routePlan = res.getPlan(i);
//获取时耗
int time = routePlan.getTime() / 60;
int hour = time / 60;
int min = time % 60;
// 公交线路
MKLine mkLine = routePlan.getLine(0);
//记录方案详细信息
StringBuilder sb = new StringBuilder();
sb.append("[预计耗时：");
if(hour > 0)sb.append(hour + " 小时 ");
sb.append(min);
sb.append("分钟]\n\n乘坐：");
sb.append(mkLine.getTitle());
MKPoiInfo mkOnPoiInfo = mkLine.getGetOnStop();
MKPoiInfo mkOffPoiInfo = mkLine.getGetOffStop();
sb.append("\n从");
sb.append(mkOnPoiInfo.name);
sb.append("上车，在");
sb.append(mkOffPoiInfo.name);
sb.append("下车\n[途经 ");
sb.append(mkLine.getNumViaStops());
sb.append(" 站]");
if (routePlan.getNumLines() > 0) {
// 循环当前方案公交路线
for (int j = 1; j < routePlan.getNumLines(); j++) {
// 公交线路
mkLine = routePlan.getLine(j);
sb.append("\n换乘：");
sb.append(mkLine.getTitle());
mkOnPoiInfo = mkLine.getGetOnStop();
mkOffPoiInfo = mkLine.getGetOffStop();
sb.append("\n从");
sb.append(mkOnPoiInfo.name);
sb.append("上车，在");
sb.append(mkOffPoiInfo.name);
sb.append("下车\n[途经 ");
sb.append(mkLine.getNumViaStops());
sb.append(" 站]");
}
}
//填充详细方案列表
details.add(sb.toString()); //填充方案列表
plans.add("方案 " + (i + 1));
}
//显示方案列表
showPlans();
} public void onGetWalkingRouteResult(MKWalkingRouteResult res,
int error) {
} public void onGetAddrResult(MKAddrInfo res, int error) {
} //线路查询相关
public void onGetPoiResult(MKPoiResult res, int type, int error) {
// 错误号可参考MKEvent中的定义
if (error != 0 || res == null) {
showError(error);
return;
}
// 找到公交路线poi node
MKPoiInfo curPoi = null;
int totalPoiNum = res.getNumPois();
for (int idx = 0; idx < totalPoiNum; idx++) {
curPoi = res.getPoi(idx);
// ePoiType-->poi类型，0：普通点，1：公交站，2：公交线路，3：地铁站，4：地铁线路
if (2 == curPoi.ePoiType) {
break;
}
}
mSearch.busLineSearch(curPoi.name, curPoi.uid);
} //线路查询相关
public void onGetBusDetailResult(MKBusLineResult result, int error) {
if (error != 0 || result == null) {
showError(error);
return;
}
//获取详细路线
MKRoute route = result.getBusRoute();
int num = route.getNumSteps();//关键点数量
//循环获取关键点描述
String[] arrInfo = new String[num + 1];
for(int i = 0;i < num;i++)
arrInfo[i + 1] = route.getStep(i).getContent();
//获取运营时间信息
String busName = result.getBusName();
String startTime = result.getStartTime();
String endTime = result.getEndTime();
arrInfo[0] = busName + "\n首班:" + startTime + "\n末班:" + endTime; //将数据装入Bundle
Bundle data = new Bundle();
data.putStringArray("routeInfo", arrInfo);
//新建Intent
Intent intent = new Intent(SearchPlan.this,ShowRoute.class);
intent.putExtras(data);
//启动对应Activity
startActivity(intent);
} @Override
public void onGetSuggestionResult(MKSuggestionResult res, int arg1) {
// TODO Auto-generated method stub
} @Override
public void onGetShareUrlResult(MKShareUrlResult arg0, int arg1,
int arg2) {
// TODO Auto-generated method stub
}
});
} @Override
public boolean onCreateOptionsMenu(Menu menu) {
// Inflate the menu; this adds items to the action bar if it is present.
getMenuInflater().inflate(R.menu.main, menu);
return true;
} @Override
public boolean onOptionsItemSelected(android.view.MenuItem item){
if(item.getItemId() == R.id.searchRoute)
{//显示线路查询对话框
//创建Builder对象
Builder builder = new Builder(SearchPlan.this);
builder.setTitle("查询线路详情");
builder.setIcon(R.drawable.search);
//设置对话框内容
LinearLayout view = new LinearLayout(SearchPlan.this);
view.setOrientation(LinearLayout.HORIZONTAL);
TextView lbl1 = new TextView(SearchPlan.this);
lbl1.setText("查询");
lbl1.setTextSize(18);
final EditText txtCity = new EditText(SearchPlan.this);
txtCity.setHint("城市名");
txtCity.setText("西安");
TextView lbl2 = new TextView(SearchPlan.this);
lbl2.setText("公交");
lbl2.setTextSize(18);
final EditText txtBus = new EditText(SearchPlan.this);
txtBus.setInputType(InputType.TYPE_CLASS_NUMBER);//限输入数字
txtBus.setSingleLine();//单行
txtBus.setHint("线路名");
TextView lbl3 = new TextView(SearchPlan.this);
lbl3.setText("路");
lbl3.setTextSize(18);
view.addView(lbl1);
view.addView(txtCity);
view.addView(lbl2);
view.addView(txtBus);
view.addView(lbl3);
builder.setView(view);
//添加按钮
builder.setPositiveButton("查询", new DialogInterface.OnClickListener() { @Override
public void onClick(DialogInterface dialog, int which) {
//查询路线信息
//判空
String city = txtCity.getText().toString().trim();
String bus = txtBus.getText().toString().trim();
if("".equals(city) || "".equals(bus))
{
Toast.makeText(SearchPlan.this, "...到底想查询什么", Toast.LENGTH_SHORT).show();
return;
} //显示提示信息
showTip();
//POI搜索
mSearch.poiSearchInCity(city, bus);
}
});
builder.setNegativeButton("取消", null);
//显示对话框
builder.create().show();
} if(item.getItemId() == R.id.exit)
finish();//退出程序 return true;
}; //自定义方法
private void searchPlans()
{//搜索乘车方案 //对起点终点的name进行赋值，也可以直接对坐标赋值，赋值坐标则将根据坐标进行搜索
MKPlanNode stNode = new MKPlanNode();
stNode.name = start;
MKPlanNode enNode = new MKPlanNode();
enNode.name = end; //显示提示信息
showTip();
//搜索
mSearch.transitSearch(city, stNode, enNode);
} private void showPlans()
{
//为ListView绑定Adapter
ArrayAdapter<String> adapter = new ArrayAdapter<String>(this
, android.R.layout.simple_list_item_multiple_choice
, plans);
list.setAdapter(adapter);
list.setChoiceMode(ListView.CHOICE_MODE_MULTIPLE); //为ListView添加ItemClick事件监听
list.setOnItemClickListener(new OnItemClickListener() { @Override
public void onItemClick(AdapterView<?> arg0, View arg1, int index,
long arg3) {
//跳转到ListActivity,同时传递索引参数 //创建Intent
Intent intent = new Intent(SearchPlan.this
,ShowDetail.class);
//创建Bundle携带数据
Bundle bundle = new Bundle();
bundle.putInt("index", index);
bundle.putString("detail", details.get(index));
//数据绑定
intent.putExtras(bundle);
//启动Intent对应的Activity
startActivity(intent);
}
});
} private void showError(int error)
{
String msg = null;
switch(error)
{
case 2:msg="T_T网络连接错误...";break;
case 3:msg="T_T网络数据错误...";break;
case 4:msg="T_T路线搜索起点或终点有歧义...";break;
case 100:msg="T_T未找到搜索结果...";break;
case 300:msg="T_T授权验证失败...";break;
default:msg="T_T未知错误...";
}
Toast.makeText(SearchPlan.this, msg,
Toast.LENGTH_LONG).show();
} private void showTip()
{//显示提示信息
Toast.makeText(SearchPlan.this
, "（*>.<*）正在拼命搜索..."
, Toast.LENGTH_LONG).show();
} //重写baiduMap中的方法
@Override
protected void onDestroy() {
mSearch.destory(); if(mBMapMan!=null){
mBMapMan.destroy();
mBMapMan=null;
} super.onDestroy();
} @Override
protected void onPause(){
if(mBMapMan!=null){
mBMapMan.stop();
}
super.onPause();
} @Override
protected void onResume(){
if(mBMapMan!=null){
mBMapMan.start();
}
super.onResume();
} }
[ShowDetail.java---显示乘车方案详情]
package com.ayqy.app_gowithme; import android.app.ListActivity;
import android.content.Intent;
import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.ListView; public class ShowDetail extends ListActivity{ ListView root; @Override
protected void onCreate(Bundle savedInstanceState) {
// TODO Auto-generated method stub
super.onCreate(savedInstanceState); //设置背景
root = getListView();
root.setBackgroundResource(R.drawable.blue_bg); //获取数据
Intent intent= getIntent();
Bundle bundle = intent.getExtras();
int index = bundle.getInt("index") + 1;
String detail = bundle.getString("detail"); //设置Adapter
String[] arr = new String[]{"方案 " + index + " 详情:", detail};
ArrayAdapter<String> adapter = new ArrayAdapter<String>(this
, android.R.layout.simple_list_item_1
, arr);
this.setListAdapter(adapter);
}
}
[ShowRoute.java---显示路线详情（沿途站点信息）]
package com.ayqy.app_gowithme; import android.app.ListActivity;
import android.content.Intent;
import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.ListView; public class ShowRoute extends ListActivity{ ListView root; @Override
protected void onCreate(Bundle savedInstanceState) {
// TODO Auto-generated method stub
super.onCreate(savedInstanceState); //设置背景
root = getListView();
root.setBackgroundResource(R.drawable.blue_bg); //获取数据
Intent intent= getIntent();
Bundle bundle = intent.getExtras();
String[] arrInfo = bundle.getStringArray("routeInfo"); //设置Adapter
ArrayAdapter<String> adapter = new ArrayAdapter<String>(this
, android.R.layout.simple_list_item_1
, arrInfo);
this.setListAdapter(adapter);
}
}
[布局文件query.xml]
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="bottom"
android:background="@drawable/blue_bg"
android:orientation="vertical" > <LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
> <TextView
android:text="@string/city"
android:textSize="24sp"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
/> <EditText
android:id="@+id/txtCity"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:hint="@string/cityHint"
android:text="@string/XiAn"
android:singleLine="true"
/> </LinearLayout> <LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
> <TextView
android:text="@string/start"
android:textSize="24sp"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
/> <EditText
android:id="@+id/txtStart"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:hint="@string/stationHint"
android:singleLine="true"
/> </LinearLayout> <LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
> <TextView
android:text="@string/end"
android:textSize="24sp"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
/> <EditText
android:id="@+id/txtEnd"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:hint="@string/stationHint"
android:singleLine="true"
/> </LinearLayout> <Button
android:id="@+id/btnSearch"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:textSize="18sp"
android:text="@string/searchPlan"
/> <ListView android:id="@+id/List"
android:layout_width="match_parent"
android:layout_height="wrap_content"
> </ListView> </LinearLayout>
P.S.源码都在上面，如有疑问请在下方留言
（六）显示地图
[最先实现的就是这个（第一次开发地图有点激动，想看看地图长什么样子...），在需求中本没打算设计，虽然后来放弃了，但下面的源码仍然亲测无误]
[ShowMap.java---显示地图]
package com.ayqy.app_gowithme; import android.app.Activity;
import android.graphics.Bitmap;
import android.os.Bundle;
import android.view.Menu;
import android.widget.TextView;
import android.widget.Toast; import com.baidu.mapapi.BMapManager;
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 ShowMap extends Activity { BMapManager mBMapMan = null;
MapView mMapView = null;
MapController mMapController = null; TextView txt;
boolean pressAgain = false;
long pressTime = 0; @Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState); mBMapMan=new BMapManager(getApplication());
mBMapMan.init("MzKbxcvX7gBEqpeW2kdmOqhx", null);
//注意：请在试用setContentView前初始化BMapManager对象，否则会报错 setContentView(R.layout.activity_main);
mMapView=(MapView)findViewById(R.id.bmapsView);
mMapController=mMapView.getController(); //txt = (TextView) findViewById(R.id.txt); // 得到mMapView的控制权,可以用它控制和驱动平移和缩放
GeoPoint point =new GeoPoint((int)(34.151884* 1E6),(int)(108.882024* 1E6));
//34.151884,108.882024西北大学16级别
//用给定的经纬度构造一个GeoPoint，单位是微度 (度 * 1E6)
mMapController.enableClick(true);//设置地图响应点击事件
mMapController.setCenter(point);//设置地图中心点
mMapController.setZoom(16);//设置地图zoom级别
mMapView.setBuiltInZoomControls(false);//不显示内置缩放控件 //创建MKMapViewListener
MKMapViewListener listener = new MKMapViewListener() { @Override
public void onMapMoveFinish() {
// TODO Auto-generated method stub } @Override
public void onMapLoadFinish() {
} @Override
public void onMapAnimationFinish() {
// TODO Auto-generated method stub } @Override
public void onGetCurrentMap(Bitmap arg0) {
// TODO Auto-generated method stub } @Override
public void onClickMapPoi(MapPoi arg0) {
//点到地图标注时显示详细
if(arg0 != null)
{
GeoPoint point = arg0.geoPt;//获取GEO坐标
mMapController.setCenter(point);//设置地图中心点
mMapController.zoomIn();//放大一个级别
}
}
};
//为map注册监听器
mMapView.regMapViewListener(mBMapMan, listener);
} @Override public void onBackPressed() {
//按下返回键，缩小地图
float min = 12f;//设置最小缩放级别
if(mMapView.getZoomLevel() > min)
mMapController.zoomOut();//缩小一个级别
else
{
if(pressAgain && (System.currentTimeMillis() - pressTime < 1000))
super.finish();//一秒内再按结束程序
else
pressAgain = false;
if(!pressAgain)
{
Toast.makeText(ShowMap.this, "再按一次退出...", Toast.LENGTH_SHORT).show();
pressTime = System.currentTimeMillis();//获取第一次按下的时间
pressAgain = true;
}
}
}; @Override
public boolean onCreateOptionsMenu(Menu menu) {
// Inflate the menu; this adds items to the action bar if it is present.
getMenuInflater().inflate(R.menu.main, menu);
return true;
} @Override
public boolean onOptionsItemSelected(android.view.MenuItem item){
if(item.getItemId() == R.id.exit)
finish();//退出程序 return true;
}; //重写baiduMap中的方法
@Override
protected void onDestroy() {
mMapView.destroy();
if(mBMapMan!=null){
mBMapMan.destroy();
mBMapMan=null;
} super.onDestroy();
} @Override
protected void onPause(){
mMapView.onPause();
if(mBMapMan!=null){
mBMapMan.stop();
}
super.onPause();
} @Override
protected void onResume(){
mMapView.onResume();
if(mBMapMan!=null){
mBMapMan.start();
}
super.onResume();
}
}
[布局文件activity_main.xml]
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:orientation="vertical"
android:scrollbars="none" > <com.baidu.mapapi.map.MapView
android:id="@+id/bmapsView"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:clickable="true" /> </LinearLayout>
(七）离线地图
离线地图好处多多，但若是要开发需要推广给众多用户的App的话，建议要么做下载离线地图包功能（Demo中有例程，很容易），要么考虑在App第一次运行的时候把APK资源文件中的离线地图复制到用户SD卡中（理论上可以实现），当然这样的话地图适用范围会受到限制，开发有明确地域限制的App可以选用（例如：西安出行助手）。
离线地图是这样用的：
1.把从官网下载的文件夹整个复制到手机SDCARD指定路径（具体放哪里请看压缩包中的ReadMe.txt介绍）
2.在程序中需要对离线地图包进行scan初始化（其本质是对地图包的解析，把一个大文件变成了几个小文件，所以，不进行解析的话地图包是不能用的）
3.貌似显示地图的方法会自动判断（优先使用离线地图，如果有的话）
（八）运行界面截图