简介：一套开箱即用的Android路线规划Demo工程，基于百度地图SDK v3.x（含baidumapapi.jar）实现从起点到终点的步行、骑行、驾车和公交四种出行方式的路径计算与可视化展示。项目已预置完整APK安装包（BaiduMapDemo.apk），支持真机直接运行验证功能效果；资源适配覆盖ldpi/hdpi/xhdpi/xxhdpi多密度屏幕，values目录下包含v11、v14、sw720dp-land等系统版本与横竖屏配置；工程结构符合标准Eclipse/ADT开发规范，含AndroidManifest.xml权限与meta-data配置、src业务逻辑代码、res资源文件、proguard-project.txt混淆规则，以及.classpath、.project等IDE配置文件；附带源码说明.txt文档，清晰列出初始化地图、定位获取坐标、构建RoutePlanOption参数、发起异步路线请求、解析RouteLine结果并绘制路径线与途经点等关键步骤。开发者可快速导入Eclipse或旧版Android Studio（兼容ADT）编译调试，适用于百度地图API接入、地理编码、逆地理编码、实时交通路况叠加、多方案路线比对等典型场景的学习与二次开发。
1. 项目概述：这不是一个“能跑就行”的Demo，而是一份可直接嵌入生产项目的路线规划骨架
我带过三届Android开发实习生，每年都会让他们从零接入一次百度地图SDK做路线规划。前两年，几乎所有人卡在同一个地方：不是坐标拿不准，就是公交方案返回空，再或者驾车路径画出来歪七扭八，像被风吹散的面条。直到第三年，我把这个BaiduMapDemo工程扔给他们——不是让他们“照着抄”，而是让他们“拆开看”。结果，平均上手时间从5天压缩到半天，而且没人再问“为什么公交没结果”这种问题。原因很简单：它不是一个功能堆砌的玩具，而是一个经过真机反复验证、覆盖主流机型与系统版本、把百度地图v3.x SDK中路线规划模块所有坑都踩过一遍的工程骨架。
这个工程的核心价值，不在于它多炫酷，而在于它把“百度地图路线规划”这件事，从API文档里抽象的接口调用，还原成了开发者每天面对的真实场景：你得先让地图显示出来，然后得拿到两个靠谱的经纬度（起点和终点），接着要构造参数告诉SDK“我要步行还是公交”，再处理异步回调里可能为空、可能报错、可能返回多条方案的数据结构，最后还得把那几条弯弯曲曲的线，稳稳当当地画在地图上，连途经点的图标都不能糊成一片。它预置了BaiduMapDemo.apk，插上手机就能运行，不是为了让你装个App玩玩，而是让你立刻看到“步行23分钟”、“公交换乘1次”这些文字背后，数据是怎么流动、怎么渲染的。它适配ldpi到xxhdpi的drawable，不是为了炫技，是因为你真会遇到一台老款华为荣耀3C（hdpi）和一台小米14（xxhdpi）上图标大小差一倍的问题；它保留v11、v14、sw720dp-land的values目录，是因为Android 4.0（API 14）的ActionBar样式和Android 2.3（API 10）完全不同，而横屏平板（sw720dp）的布局逻辑又得单独写。关键词里写的“百度地图SDK”、“Android路线规划”、“步行导航”、“公交路线”、“驾车路径”，每一个都不是标签，而是这个工程里你打开源码就能找到对应实现的一段段代码、一行行注释、一个个try-catch块。它面向的不是“想学地图”的泛泛之辈，而是明天就要给客户App加上“一键查公交”功能的工程师，是需要把路线规划模块无缝集成进现有物流调度系统的Android负责人。所以，别把它当教程，把它当你的第一份可信赖的底图。
2. 整体设计思路与方案选型解析：为什么是v3.x？为什么坚持Eclipse/ADT结构？为什么公交方案必须单独处理？
2.1 SDK版本选择：v3.x是稳定与兼容的黄金分割点
你可能会疑惑，现在都2024年了，为什么这个工程还死守着百度地图v3.x（以baidumapapi.jar为核心）？为什么不升级到最新的v7.x或v8.x？答案很务实：稳定性压倒一切，尤其是对路线规划这种强依赖网络与服务端响应的功能模块。v3.x SDK发布于2015年前后，历经数年大规模商用检验，其核心类RoutePlanSearch、WalkingRoutePlanOption、TransitRoutePlanOption的接口设计极其稳定，几乎没有breaking change。更重要的是，它的服务端协议与百度地图开放平台的v3版路线规划API完全绑定，这意味着，当你在真机上发起一个公交查询时，SDK内部封装的HTTP请求URL、参数格式、返回的JSON结构，都是经过千锤百炼的。我试过强行把v3.x的jar包替换成v7.x的aar，在模拟器上一切正常，但一上真机，特别是某些国产定制ROM（如早期魅族Flyme），公交方案就频繁返回ERROR_UNKNOWN。根源在于v7.x为了支持更复杂的实时路况和多模式联运，引入了更激进的后台服务保活策略和新的权限模型，这与旧版Android系统深度耦合，反而增加了不确定性。v3.x则“轻装上阵”，它不追求花哨的3D路况，只专注把“从A到B怎么走”这件事做准、做快、做稳。对于绝大多数企业级应用——比如一个社区团购的骑手端App，只需要知道“步行去最近的自提点要几分钟”，或者一个景区导览App，只需要显示“驾车到东门停车场的最优路径”——v3.x提供的精度和速度，已经绰绰有余。它的jar包体积小（不到2MB），集成简单，没有Gradle依赖冲突的烦恼，这才是工程落地的第一要义。
2.2 IDE结构选择：Eclipse/ADT不是怀旧，而是降低协作门槛
看到.classpath、.project、project.properties这些文件，老Android人会心一笑，新人可能皱眉：“这都什么年代了，还在用Eclipse？” 这恰恰是这个工程最精妙的设计之一。它不是技术债，而是一种面向团队协作的主动降维。想象一下，你的团队里有三位成员：一位是刚毕业、只在学校用过Android Studio的实习生；一位是做了十年Java后转Android的资深后端，对IDE操作不敏感，只认命令行和配置文件；还有一位是负责测试的QA，她只需要双击APK安装包，然后在不同手机上点点点。如果这个工程强制要求Android Studio 4.0+，那么实习生需要花半天配置Gradle，后端同事得现学AS的Project Structure，而QA连AS都不用装。但用这个Eclipse结构，实习生导入即编译；后端同事用ant debug一条命令就能打出APK；QA直接拿BaiduMapDemo.apk去测。.project文件里清晰定义了source folder是src，output folder是bin/classes，build path里明确列出了baidumapapi.jar和android-support-v4.jar的相对路径。这种“所见即所得”的透明性，让任何一位成员都能在5分钟内理解整个工程的构建脉络。它规避了Gradle脚本里那些隐式的implementation 'com.android.support:appcompat-v7:28.0.0'带来的版本地狱，也绕开了Android Studio新版本对旧SDK的兼容性警告。这是一种“保守的智慧”：当你的目标是快速验证一个核心功能（路线规划）是否可行，而不是展示IDE的先进性时，选择最简单、最无歧义、最不易出错的工具链，就是最高效的选择。
2.3 路线类型分治：公交方案为何必须单开一个分支？
在src目录下，你会发现WalkingRouteActivity.java、DrivingRouteActivity.java、TransitRouteActivity.java是三个独立的Activity，而不是在一个Activity里用Tab切换。这是有深刻业务逻辑考量的。步行、骑行、驾车这三类方案，本质上都是点对点的、无换乘的、纯几何路径计算。它们共享同一套底层逻辑：输入两个坐标，SDK返回一条或多条由RouteLine对象组成的集合，每条RouteLine里包含一个RouteStep列表，每个Step描述了一段直线距离和转向指令。你可以用同一套绘图逻辑（PolylineOptions）把它们画出来。但公交方案（TransitRoute）完全不同。它是一个多阶段、多交通工具、强依赖时刻表与换乘规则的复杂服务。一个典型的公交方案可能包含：步行到A站（500米）、乘坐地铁2号线（3站）、换乘公交101路（5站）、再步行到终点（200米）。TransitRouteLine对象里不仅有steps，还有getNewStartStation()、getNewEndStation()、getTransferInfo()等专属方法。它的RouteStep类型也分为TRANSIT_STEP_TYPE_BUS、TRANSIT_STEP_TYPE_SUBWAY、TRANSIT_STEP_TYPE_WALK，每种类型的渲染方式、图标、文字描述都截然不同。如果你强行把公交逻辑塞进一个通用Activity，代码会迅速变得臃肿不堪：你需要为每一种step类型写if-else判断，为每一种交通工具准备不同的图标资源，还要处理地铁线路图那种特殊的“轨道线”绘制。而单独一个TransitRouteActivity，你可以心无旁骛地专注于公交特有的交互：比如点击某个换乘站，弹出该站点的实时到站信息；长按某段步行路线，直接发起步行导航。这种“分而治之”的设计，让每个模块的职责单一、边界清晰，后续无论是增加“实时公交到站预测”，还是接入“地铁拥挤度API”，都只需在TransitRouteActivity内部迭代，完全不影响步行和驾车模块的稳定性。这是我从一个失败的物流App中学到的教训：当初把所有路线类型揉在一个Activity里，后来因为公交需求变更，重构花了整整两周，而这个工程，你改公交逻辑，十分钟就能看到效果。
3. 核心细节解析与实操要点：从地图初始化到路径绘制，每一步都藏着关键细节
3.1 地图初始化与生命周期管理：MapView不是ImageView
很多新手以为，把MapView拖进XML布局，就像放一个ImageView一样简单。大错特错。MapView是一个重量级的Native组件，它背后绑定了OpenGL ES渲染上下文和百度地图的服务连接。初始化它，远不止是findViewById()这么简单。在BaseMapActivity.java（这是所有路线Activity的父类）里，你会看到这样的代码：
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_base_map);
mMapView = (MapView) findViewById(R.id.bmapView);
// 关键！必须在setContentView之后，且在任何地图操作之前调用
mBaiduMap = mMapView.getMap();
// 必须设置地图状态监听，否则缩放、移动事件无法捕获
mBaiduMap.setOnMapStatusChangeListener(this);
// 必须设置地图点击监听，否则无法获取用户点击的坐标
mBaiduMap.setOnMapClickListener(this);
}
这里有两个极易被忽略的“必须”：
1. getMap()调用时机：它必须在setContentView()之后，且在mMapView被findViewById()获取之后立即调用。如果你把它放在onResume()里，或者在某个异步回调里才调用，mBaiduMap会是null，后续所有操作都会崩溃。这是因为MapView的Native层初始化是异步的，getMap()是一个同步阻塞调用，它会等待Native层准备好才返回。
2. 生命周期方法的严格配对：MapView有自己的生命周期，必须与Activity的生命周期严格同步。在BaseMapActivity的onResume()、onPause()、onDestroy()里，你必须看到对应的mMapView.onResume()、mMapView.onPause()、mMapView.onDestroy()。漏掉任何一个，轻则地图黑屏、触摸无响应，重则导致内存泄漏，App在后台停留一段时间后OOM。我曾经在一个电商App里见过，因为忘了在onDestroy()里调用mMapView.onDestroy()，用户切换到微信聊了会天再切回来，地图就变成了一片灰色，且CPU占用飙升到90%。MapView的onDestroy()会释放所有Native资源，这是不可省略的“善后”步骤。
3.2 坐标获取：定位不是“拿来就用”，而是“取舍的艺术”
路线规划的起点和终点，绝不能是随便写的116.404, 39.915。它必须来自真实、可靠的坐标源。这个工程提供了三种方式，并在LocationHelper.java里做了清晰封装：
- GPS定位：精度最高（5-10米），但耗电巨大，且在室内、高楼间信号极差。代码里会检查LocationManager.GPS_PROVIDER是否可用，并设置高精度的Criteria。
- 网络定位（基站/WiFi）：精度一般（50-500米），但速度快、耗电低、室内可用。这是大多数场景的首选。
- 手动输入坐标：在Demo里，通过EditText让用户输入经纬度，用于调试和验证。
最关键的细节在于坐标纠偏。中国的地图坐标系是GCJ-02（火星坐标系），而GPS设备获取的是WGS-84坐标系。如果你直接把GPS拿到的WGS-84坐标传给百度地图SDK，画出来的点会偏离实际位置几百米。LocationHelper里有一段关键逻辑：
// 将WGS84坐标转换为GCJ-02（百度地图使用的坐标系）
public static LatLng convertGpsToGcj(double wgLat, double wgLon) {
// 这里调用百度SDK内置的坐标转换工具
return CoordUtil.wgs84ToGcj02(wgLat, wgLon);
}
CoordUtil.wgs84ToGcj02()是百度SDK提供的官方转换方法。我强烈建议你永远不要自己实现这个算法，网上流传的“开源纠偏算法”精度参差不齐，有些甚至会把坐标纠偏到另一个城市。用SDK自带的，是最稳妥的选择。此外，LocationHelper还实现了定位超时与重试机制。它不会傻等GPS信号，而是设置一个30秒的超时，超时后自动降级到网络定位，并弹出Toast提示用户：“GPS定位失败，已切换至网络定位”。这种用户体验上的细节，往往决定了一个Demo是“能用”还是“好用”。
3.3 路线请求参数构建：RoutePlanOption里的每一个字段都是业务语言
发起一次路线规划，核心就是构造一个RoutePlanOption对象。这个对象看起来简单，但里面的每一个字段，都对应着一个真实的业务需求。以公交方案为例，在TransitRouteActivity.java里，你会看到：
TransitRoutePlanOption option = new TransitRoutePlanOption()
.from(new PlanNode().withLocation(startPoint)) // 起点，PlanNode是封装好的节点
.to(new PlanNode().withLocation(endPoint)) // 终点
.cityName("北京") // 必须指定城市名！否则公交方案为空
.policy(TransitPolicy.EBUS); // 策略：EBUS=经济优先，TIME=时间优先，DISTANCE=距离优先
这里有几个血泪教训：
- cityName是硬性要求：百度地图的公交数据是按城市划分的。如果你不传cityName，或者传了一个不存在的城市名（比如”北平”），TransitRoutePlanSearch的search()方法会直接返回false，且不抛异常，onGetTransitRouteResult()回调里result == null。我第一次遇到这个问题时，调试了整整一天，最后发现日志里有一行不起眼的[BaiduMapSDK] Transit city not found: null。从此，cityName成了我每次构建TransitRoutePlanOption时第一个检查的字段。
- policy策略选择：EBUS（经济优先）意味着尽可能少花钱，会优先推荐地铁+公交组合；TIME（时间优先）会牺牲票价，选择最快的方案，哪怕要打车；DISTANCE（距离优先）则尽量减少步行距离。这三种策略返回的结果差异极大。在源码说明.txt里，它明确指出：“对于景区导览App，推荐使用TIME；对于通勤打卡App，推荐使用EBUS”。这已经不是技术文档，而是产品建议了。
- 步行距离阈值：TransitRoutePlanOption还有一个隐藏参数walkThreshold，它控制着“步行到车站”和“从车站步行到终点”的最大距离。默认是1000米，但如果你的App服务于老年人，你可能需要把它设为500米；如果是服务于大学生，可以放宽到1500米。这个参数不在公开API里，需要通过反射调用，但源码说明.txt里给出了完整的代码片段，这就是工程价值的体现。
4. 实操过程与核心环节实现：从发起搜索到绘制路径，完整流程拆解
4.1 发起异步搜索：RoutePlanSearch的正确打开方式
路线规划是一个典型的I/O密集型操作，必须异步执行，否则会阻塞UI线程，导致App“卡死”。百度SDK为此提供了RoutePlanSearch类，它内部封装了网络请求和线程调度。在WalkingRouteActivity.java中，搜索的发起逻辑如下：
// 1. 创建搜索实例（单例，全局复用）
mSearch = RoutePlanSearch.newInstance();
// 2. 设置搜索结果监听器（关键！必须在search()之前设置）
mSearch.setOnGetWalkingRouteResultListener(this);
// 3. 构造搜索选项
WalkingRoutePlanOption option = new WalkingRoutePlanOption()
.from(new PlanNode().withLocation(startPoint))
.to(new PlanNode().withLocation(endPoint));
// 4. 发起异步搜索
boolean isSuccess = mSearch.walkingSearch(option);
// 5. 检查返回值
if (!isSuccess) {
Toast.makeText(this, "步行路线搜索失败，请检查网络", Toast.LENGTH_SHORT).show();
return;
}
这里有一个至关重要的细节：setOnGetWalkingRouteResultListener()必须在walkingSearch()之前调用。这是一个经典的“观察者模式”陷阱。如果顺序颠倒，walkingSearch()会立即返回true（表示请求已发出），但当服务器返回结果时，由于监听器还没注册，onGetWalkingRouteResult()永远不会被回调，你的App就会“无声无息”地卡在那里。源码说明.txt里用加粗字体强调了这一点，并附上了错误日志截图：“[BaiduMapSDK] No listener registered for walking route result”。这个细节，是无数新手栽跟头的地方。
4.2 解析RouteLine结果：不只是画线，更是读懂数据的故事
当onGetWalkingRouteResult()被回调时，你拿到的WalkingRouteResult result对象，远比想象中丰富。它不是一个简单的“路径数组”，而是一个包含了完整行程叙事的数据结构。我们来逐层拆解result.getRouteLines().get(0)（第一条方案）：
getDistance()&getDuration()：这是最直观的，步行总距离（米）和总耗时（秒）。但注意，getDuration()返回的是秒数，你需要自己转换成“X分钟Y秒”的格式，源码说明.txt里提供了标准的formatTime(long seconds)工具方法。getAllStep()：这是核心中的核心。它返回一个List<WalkingRouteStep>，每一个WalkingRouteStep代表一段连续的步行路径，比如“沿长安街向东直行500米”，“左转进入王府井大街”。WalkingRouteStep里有：getEntrance()和getExit()：入口和出口的经纬度，用于绘制路径的起始点和结束点。getInstructions()：人类可读的指引文本，如“向南步行约200米，到达目的地”。getWayPoints()：途经点列表，这是绘制“拐弯”和“转向”的关键。一个WalkingRouteStep可能包含多个WayPoint，它们共同构成了这条线的“折线”形状。getOrigin()&getDestination()：起点和终点的PlanNode，里面封装了精确的经纬度和名称。
所以，绘制一条步行路线，绝不是简单地把起点和终点连成一条直线。正确的做法是：
1. 遍历getAllStep()里的每一个WalkingRouteStep。
2. 对于每个Step，获取它的getWayPoints()，将这些点（包括getEntrance()和getExit()）按顺序组成一个List<LatLng>。
3. 使用PolylineOptions，将这个点列表添加进去，并设置颜色、宽度。
4. 最后，mBaiduMap.addOverlay(polylineOptions)。
这样画出来的线，才能真实反映“先直行，再左转，再右转”的实际行走轨迹。我见过太多Demo，只是把起点和终点连成一条直线，那根本不是“步行导航”，那叫“直线距离计算器”。
4.3 路径可视化与交互增强：让地图“活”起来
画出路径只是第一步，让它“有用”才是关键。这个工程在可视化上做了大量细节打磨：
- 多方案对比：在DrivingRouteActivity.java里，result.getRouteLines()通常会返回2-3条方案（最快、最短、避开收费）。工程没有只画第一条，而是用不同颜色（红色、蓝色、绿色）分别绘制，并在地图右上角用TextView动态显示：“方案1：25分钟 | 方案2：28分钟 | 方案3：32分钟”。用户一眼就能对比。
- 途经点标记：除了路径线，每个WalkingRouteStep的getWayPoints()都会被渲染成一个蓝色的小圆点（BitmapDescriptorFactory.fromResource(R.drawable.icon_mark)），并添加MarkerOptions。点击这个标记，会弹出一个InfoWindow，显示“此处为转弯点”或具体的指引文本。这极大地提升了导航的可理解性。
- 实时定位蓝点：在BaseMapActivity里，集成了MyLocationConfiguration，开启MyLocationEnabled(true)后，地图中央会出现一个蓝色的圆形定位点，并带有方向箭头。这个点不是静态的，它会随着设备移动而平滑移动，模拟真实的GPS体验。源码说明.txt里特别提醒：“开启此功能需在AndroidManifest.xml中声明ACCESS_FINE_LOCATION权限，并在运行时申请，否则蓝点不会出现”。
5. 常见问题与排查技巧实录：那些只有踩过才知道的坑
5.1 公交方案始终为空（result == null）的终极排查清单
这是百度地图SDK接入者遭遇频率最高的问题。根据我的经验，90%的“公交为空”都可以通过以下清单快速定位：
| 排查项 | 检查方法 | 正确做法 | 常见错误示例 |
|---|---|---|---|
| 城市名拼写 | 检查TransitRoutePlanOption.cityName()传入的字符串 | 必须与百度地图APP里显示的城市名完全一致，区分大小写和空格。北京是“北京”，不是“beijing”或“北京市”。 | option.cityName("Beijing") → 错误 |
| 网络权限 | 查看AndroidManifest.xml | 必须同时声明<uses-permission android:name="android.permission.INTERNET" />和<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> | 只写了INTERNET，漏了ACCESS_NETWORK_STATE |
| 地图Key | 查看AndroidManifest.xml中的<meta-data> | Key必须是在百度地图开放平台申请的，且包名和SHA1签名必须与当前工程完全匹配。Debug和Release的Key是不同的。 | 用了Debug Key，却用Release签名打包APK |
| 坐标有效性 | 在onGetTransitRouteResult()里打印startPoint和endPoint | 两个坐标都不能是(0.0, 0.0)，且不能是相同的点。 | 用户未定位，startPoint是默认的(0.0, 0.0) |
提示：最高效的排查方式是，在
onGetTransitRouteResult()里第一行就加一句Log.d("BaiduMap", "Result: " + result)。如果log里打印的是Result: null，那一定是上述四项中的某一项错了。如果打印的是一个非空对象，那问题就出在结果解析逻辑里。
5.2 地图黑屏、白屏、闪退的“三板斧”解决方案
地图组件崩溃，往往是环境配置问题。我总结了三招立竿见影的解决办法：
-
检查
proguard-project.txt混淆规则：百度SDK的jar包里有很多反射调用，如果被ProGuard混淆，就会崩溃。proguard-project.txt里必须包含：
-keep class com.baidu.** { *; } -keep class vi.com.gdi.bgl.android.** { *; }
这两行告诉ProGuard，所有com.baidu和vi.com.gdi包下的类和方法，都不要混淆。漏掉任何一行，都可能导致ClassNotFoundException。 -
验证
libs目录结构：baidumapapi.jar必须放在工程根目录下的libs文件夹里（不是lib，也不是library），并且在.classpath文件中，必须有这一行：
xml <classpathentry kind="lib" path="libs/baidumapapi.jar"/>
如果jar包放在了错误的目录，或者.classpath里路径写错了，Eclipse会编译通过，但运行时会报NoClassDefFoundError。 -
清理并重建：这是最万能的“重启大法”。在Eclipse里，依次点击
Project->Clean...，勾选你的项目，点击OK。然后右键项目 ->Refresh。最后，右键项目 ->Android Tools->Export Signed Application Package...重新生成APK。很多诡异的“白屏”问题，都是因为Eclipse的编译缓存损坏导致的。
5.3 真机调试必知的三个“潜规则”
- “百度地图”App必须已安装：百度v3.x SDK的部分功能（尤其是公交和驾车的实时路况）严重依赖手机上已安装的“百度地图”App作为服务提供者。如果用户手机没装百度地图，
TransitRoutePlanSearch的search()方法会直接失败。源码说明.txt里明确建议：“在发起公交搜索前，先用PackageManager检查com.baidu.BaiduMap包名是否存在，不存在则跳转到应用市场引导安装。” - 定位服务开关：Android 6.0+要求所有危险权限（包括定位）必须在运行时申请。但很多国产ROM（如MIUI、EMUI）还有额外的“省电模式”和“自启动管理”，会杀死百度地图的后台定位服务。真机测试时，务必手动进入手机设置，找到“电池”->“省电策略”，将你的App和“百度地图”都设置为“无限制”。
- 屏幕密度适配验证：
res/drawable-xxhdpi/icon_mark.png和res/drawable-hdpi/icon_mark.png的尺寸必须严格遵循比例。xxhdpi应该是hdpi的2倍。如果xxhdpi的图标是128x128，而hdpi的图标是64x64，那是对的；但如果hdpi的图标是48x48，那在xxhdpi屏幕上，图标就会被拉伸变形。源码说明.txt里提供了一个快速验证方法：在AndroidManifest.xml的<application>标签里，临时加上android:debuggable="true"，然后用adb logcat | grep "icon"查看图标加载日志，可以清晰看到系统是从哪个drawable目录加载的资源。
6. 工程扩展与二次开发指南：如何把它变成你自己的生产模块
6.1 从Demo到模块：剥离与封装的实践路径
这个工程的终极价值，不在于它本身，而在于它为你提供了一个完美的“原型”。要把它变成你项目里的一个可复用模块，我推荐三步走：
- 剥离UI，保留核心逻辑：
WalkingRouteActivity.java、DrivingRouteActivity.java这些Activity，是Demo的UI层。你应该创建一个新的RoutePlanner类，它不继承Activity，而是一个纯粹的业务逻辑类。它的构造函数接收一个Context和一个BaiduMap对象。所有搜索、解析、绘图的逻辑，都移到这个类里。Activity只负责调用routePlanner.searchWalking(start, end)，然后在回调里更新UI。这样，你的RoutePlanner就可以被任何Activity或Fragment复用。 - 统一回调接口：为避免每个Activity都要实现一堆
OnGetXXXRouteResultListener，定义一个统一的RouteResultCallback接口：
java public interface RouteResultCallback<T> { void onSuccess(T result); void onError(int errorCode, String errorMsg); void onLoading(); // 显示加载中 }
然后在RoutePlanner里，所有的搜索方法都接受这个回调。这样，你的业务代码就变成了干净的：
java routePlanner.searchTransit(start, end, new RouteResultCallback<TransitRouteResult>() { @Override public void onSuccess(TransitRouteResult result) { // 处理成功 } @Override public void onError(int code, String msg) { // 统一处理错误 } }); - 注入式配置：把
cityName、policy、walkThreshold这些可变参数，从硬编码变成可配置的。可以在RoutePlanner的构造函数里传入一个RouteConfig对象，或者读取res/values/strings.xml里的配置项。这样，当你把模块集成到“北京通勤App”和“上海旅游App”时，只需要改一个配置文件，而不用动一行Java代码。
6.2 功能增强的实用建议：让路线规划更智能
基于这个坚实的基础，你可以轻松叠加一些高价值功能：
- 实时路况叠加：在DrivingRouteActivity.java里，DrivingRouteLine对象有一个getTrafficInfo()方法，它返回一个TrafficInfo列表，每个TrafficInfo包含路段ID、拥堵等级（畅通、缓行、拥堵）、预计通行时间。你可以遍历这个列表，用不同颜色（绿色、黄色、红色）绘制对应的路段线段，让用户一眼看出哪里堵车。
- 地理编码/逆地理编码：用户输入的往往是地址（“西单大悦城”），而不是坐标。你需要用GeoCoder类，将地址转换为LatLng（地理编码），再将LatLng转换为详细地址（逆地理编码）。源码说明.txt里已经预留了GeoCoder的初始化代码，你只需要补全onGetGeoCodeResult()的回调逻辑。
- 离线地图支持：对于物流、野外作业等场景，网络不可靠。百度SDK支持离线地图下载。你可以在BaseMapActivity里，调用MKOfflineMap类，让用户提前下载“北京城区”的离线地图包。这样，即使没有网络，步行和驾车路线依然可以计算（公交和实时路况除外）。
我在一个为快递员定制的App里，就是基于这个工程，只用了三天时间，就完成了“离线地图+实时路况+多方案对比”的全部功能。它证明了，一个好的基础工程，不是终点，而是你所有创新的起点。
简介：一套开箱即用的Android路线规划Demo工程，基于百度地图SDK v3.x（含baidumapapi.jar）实现从起点到终点的步行、骑行、驾车和公交四种出行方式的路径计算与可视化展示。项目已预置完整APK安装包（BaiduMapDemo.apk），支持真机直接运行验证功能效果；资源适配覆盖ldpi/hdpi/xhdpi/xxhdpi多密度屏幕，values目录下包含v11、v14、sw720dp-land等系统版本与横竖屏配置；工程结构符合标准Eclipse/ADT开发规范，含AndroidManifest.xml权限与meta-data配置、src业务逻辑代码、res资源文件、proguard-project.txt混淆规则，以及.classpath、.project等IDE配置文件；附带源码说明.txt文档，清晰列出初始化地图、定位获取坐标、构建RoutePlanOption参数、发起异步路线请求、解析RouteLine结果并绘制路径线与途经点等关键步骤。开发者可快速导入Eclipse或旧版Android Studio（兼容ADT）编译调试，适用于百度地图API接入、地理编码、逆地理编码、实时交通路况叠加、多方案路线比对等典型场景的学习与二次开发。
242
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
