Android 高仿百度地图的LBS服务——路线规划篇（v 3.1.1）

﹏ヽ暗。殇╰゛Y 2022-08-14 00:42 140阅读 0赞

一、前言

转载请标明出处：[http://blog.csdn.net/wlwlwlwl015/article/details/41091099][http_blog.csdn.net_wlwlwlwl015_article_details_41091099]

上一篇blog介绍了百度地图SDK的一些基本用法[（模仿百度地图的LBS服务——基础地图篇）][LBS]，本篇blog将记录关于路径规划的具体使用方法，其中还包括了坐标转换地址、自定义RouteResult、计算路线的距离与所耗时间等等。下一篇博客将介绍离线地图的功能，同样也是高仿百度地图的离线地图模块[（模仿百度地图的LBS服务——离线地图篇 Part1）][LBS_ Part1]。

二、"到这去"功能剖析

这个是我集成的LBS服务中的核心功能，即我的当前定位点，到目标Marker怎么走的问题。首先简单的介绍一下百度SDK的路线规划，首先每一条路线都有三种规划方式，分别是：驾车、公交和步行。实现路线规划大体可以分为以下几个步骤：

a.设置起点和终点

b.通过RoutePlanSearch发起路线查询

c.在回调方法中根据得到RouteResult查询结果

d.自定义DrivingRouteOverlay类去做路线定制

e.将路线的Overlay绘制在地图上

f.提取RouteResult的路线中每一个Step的数据并做相应的展示以及总距离和总时间的计算

**Part A.**

根据之前的界面，我们再细化一下功能，点击“到这去”按钮的时候，首先从顶部弹出一个PopupWindow，有两个文本框和三个按钮，分别用于输入起点、终点，按钮分别是驾车、公交、步行这三种路线规划。但是很明显在“到这去”的功能中，起点和终点是不需要用户去输入的，起点就是当前所在的定位点，而终点就是我们所点击的Marker的位置，这个Marker在初始化的时候就已经知道了坐标，但是直接在文本框显示坐标是不行的，我们需要将坐标转换成位置信息再填充到PopupWindow的文本框中。首先我们看一下效果图，和上一篇博客的第三幅GIF图片一致：

![20141114104533314][]

可以看到点击“到这去”按钮，会在顶部弹出一个PopupWindow，里面有两个文本框，这两个文本框也就是起点和重点的位置信息。由于模拟器无法定位所以起点的信息没有显示出来，终点的信息则通过查询可以成功的显示出来。我们在添加Marker的时候就已经知道终点的坐标，所以在这里需要做的就是将坐标转换成位置信息再setText到文本框就OK了，这里通过坐标转换成位置信息就需要用到GeoCoder的反Geo搜索了（Geo是位置转坐标，反Geo是坐标转位置）。下面贴上代码，首先是初始化部分：

GeoCoder mCoder = null;
    //初始化GeoCoder
    mCoder = GeoCoder.newInstance();
    mCoder.setOnGetGeoCodeResultListener(this);

我们的Activity或Fragment需要实现OnGetGeoCoderResultListener接口，并重写这两个回调方法，这里我们只需要用法反Geo搜索，所以重写onGetReverseGeoCodeResult方法即可。

//Geo搜索
            @Override
    	public void onGetGeoCodeResult(GeoCodeResult arg0) {
    		// TODO Auto-generated method stub
    	}
    
    	// 反Geo搜索
    	@Override
    	public void onGetReverseGeoCodeResult(ReverseGeoCodeResult result) {
    		// TODO Auto-generated method stub
    	}

然后就可以在点击按钮的时候发起反地理编码请求(经纬度->地址信息)了：

// 到这去
    	class MyOnclickListenerTwo implements OnClickListener {
    		@Override
    		public void onClick(View v) {
    			if (popupWindow != null && popupWindow.isShowing())
    				popupWindow.dismiss();
    			// 当前marker的坐标
    			LatLng currentMarkerPosition = MyFragment.this.position;
    			// 反Geo搜索
    			mCoder.reverseGeoCode(new ReverseGeoCodeOption()
    					.location(currentMarkerPosition));
    			dialog.show();
    		}
    	}

这里的MyFragment.this.position是我用来保存最后点击的特色数据坐标的全局变量，现在回头看一下OnMarkerClickListener中的代码（在上一篇blog）可以发现，每当触发Marker的点击事件时，都会将该Marker的position保存起来，而“到这去”的PopupWindow正是点击Marker之后才弹出的，所以通过这个变量自然可以得到当前Marker的坐标了。最后通过reverseGeoCode方法，根据ReverseGeoCodeOption传入的坐标，即可完成地址查询请求的发起。

当查询完毕后，我们就可以在回调方法中获取到位置信息了，由于reverseGeoCode发起的是异步请求，所以我们应当在回调方法中去得到结果并展示：

@Override
    	public void onGetReverseGeoCodeResult(ReverseGeoCodeResult result) {
    		// TODO Auto-generated method stub
    		if (result == null || result.error != SearchResult.ERRORNO.NO_ERROR) {
    			Toast.makeText(getActivity(), "抱歉，未能找到结果", Toast.LENGTH_LONG)
    					.show();
    			return;
    		}
    		reverseGeoCodeResult = result.getAddress();
    		// 当前我的位置
    		String address = mLocation.getAddrStr();
    		dialog.dismiss();
    		showPopupWindowTwo(address, reverseGeoCodeResult);
    	}

**Part B.**

有了起点和终点，接下来我们就可以通过点击三种不同的按钮分别去查询路线信息了。在百度的SDK中，路线是由RouteLine这个类表示的，它有三个直接子类，分别是DrivingRouteLine（驾车路线），TransitRouteLine（公交路线），WalkingRouteLine（步行路线），而每一条路线又是由多个路段组成的，在百度的SDK中，路段是由RouteStep这个类表示的，同理它也有几个直接子类，分别是DrivingRouteLine.DrivingStep，TransitRouteLine.TransitStep，WalkingRouteLine.WalkingStep。我们通常在路线检索的结果（RouteResult）中可以得到RouteLine对象，进而通过它的getAllStep()方法得到所有的Step并遍历依次获取路段的详细数据。

下面贴代码，同上首先是初始化部分：

// 路线
    RouteLine route = null;
    // 路线搜索相关
    RoutePlanSearch mSearch = null;
    // 初始化路线查询对象
    mSearch = RoutePlanSearch.newInstance();
    // 设置路线查询结果监听
    mSearch.setOnGetRoutePlanResultListener(this);

我们的Activity或Fragment需要实现 OnGetRoutePlanResultListener接口，并重写三种路线查询结果的回调方法：

@Override
    	public void onGetDrivingRouteResult(DrivingRouteResult arg0) {
    		// TODO Auto-generated method stub
    	}
    
    	@Override
    	public void onGetTransitRouteResult(TransitRouteResult arg0) {
    		// TODO Auto-generated method stub	
    	}
    
    	@Override
    	public void onGetWalkingRouteResult(WalkingRouteResult arg0) {
    		// TODO Auto-generated method stub	
    	}

然后就可以在点击按钮的时候发起路线查询的请求了：

// 发起路线规划搜索
    	class MySearchButtonProcessClickListener implements OnClickListener {
    		@Override
    		public void onClick(View v) {
    			if (popupWindowTwo != null && popupWindowTwo.isShowing()) {
    				popupWindowTwo.dismiss();
    			}
    			
    			// 重置浏览节点的路线数据
    			if (route != null)
    				route = null;
    			if (routeOverlay != null)
    				routeOverlay.removeFromMap();
    			mBaiduMap.clear();
    
    			// 清空路线Result
    			if (drResult != null)
    				drResult = null;
    			if (trResult != null)
    				trResult = null;
    			if (wrResult != null)
    				wrResult = null;
    
    			// 再标记一遍特色数据的marker
    			addMarkers();
    
    			// 设置起终点信息，对于tranist search 来说，城市名无意义
    			PlanNode stNode = null;
    			PlanNode enNode = null;
    			String cityName = mLocation.getCity();
    			if (position != null) {
    				// 根据坐标查询 我的坐标 ---> 目标marker
    				stNode = PlanNode.withLocation(new LatLng(mLocation
    						.getLatitude(), mLocation.getLongitude()));
    				enNode = PlanNode.withLocation(position);
    			} else {
    				// 根据城市名查询
    				stNode = PlanNode.withCityNameAndPlaceName(cityName, eStart
    						.getText().toString());
    				enNode = PlanNode.withCityNameAndPlaceName(cityName, eEnd
    						.getText().toString());
    			}
    			if (v.getId() == R.id.drive) {
    				// 显示Loading
    				dialog.show();
    				mSearch.drivingSearch((new DrivingRoutePlanOption()).from(
    						stNode).to(enNode));
    			} else if (v.getId() == R.id.transit) {
    				// 显示Loading
    				dialog.show();
    				mSearch.transitSearch((new TransitRoutePlanOption())
    						.from(stNode).city(cityName).to(enNode));
    			} else if (v == btnWalk) {
    				// 显示Loading
    				dialog.show();
    				mSearch.walkingSearch(new WalkingRoutePlanOption().from(stNode)
    						.to(enNode));
    			}
    
    		}
    
    	}

第10行到25行是一些 重置操作，毕竟每次绘制路线的时候都要清空关于上次绘制的信息，所以这里根据自己的情况去控制。可以看到33行和38行中我展示了两种设置起点终点的方法，分别是通过坐标查询和通过城市名查询，用任意一种都可以，官方提供了这两种选择。最后从43行开始，根据点击不同的按钮进入不同的分支，分别发起不同的路线查询。

**Part C.**

同Geo搜索类似，所有的搜索请求都是异步的，所以我们自然是在查询结果的回调方法中去获取结果数据了，由于这三种基本都是类似的所以我只写一下驾车的方案。驾车路线对应的回调方法是onGetDrivingRouteResult，在百度的SDK中查询出来的路线结果都是由SearchResult这个类表示的，那么自然的它也有以下的几个直接子类： DrivingRouteResult,TransitRouteResult,WalkingRouteResult，它们分别表示了这三种方案的查询结果。下面是c、d、e、f四个步骤的整体代码，先全部贴出来，再分段解释一下重点的部分：

// 驾车
    	@Override
    	public void onGetDrivingRouteResult(final DrivingRouteResult result) {
    		// 关闭Loading
    		dialog.dismiss();
    		if (result == null || result.error != SearchResult.ERRORNO.NO_ERROR) {
    			Toast.makeText(getActivity(), "抱歉，未找到结果", Toast.LENGTH_SHORT)
    					.show();
    		}
    		if (result.error == SearchResult.ERRORNO.AMBIGUOUS_ROURE_ADDR) {
    
    			return;
    		}
    		if (result.error == SearchResult.ERRORNO.NO_ERROR) {
    	
    			if (stepDetails.size() != 0)
    				stepDetails.clear();
    			if (distance != 0)
    				distance = 0;
    			if (needTime != 0)
    				needTime = 0;
    
    			route = result.getRouteLines().get(0);
    			DrivingRouteOverlay overlay = new MyDrivingRouteOverlay(mBaiduMap);
    			routeOverlay = overlay;
    
    			mBaiduMap.setOnMarkerClickListener(new MyMarkerClickListener());
    
    			overlay.setData(result.getRouteLines().get(0));
    			overlay.addToMap(); // 将所有Overlay 添加到地图上
    			overlay.zoomToSpan(); // 缩放地图，使所有Overlay都在合适的视野内 注：
    									// 该方法只对Marker类型的overlay有效
    			// 显示清理marker的垃圾桶按钮
    			imageButtonClear.setVisibility(View.VISIBLE);
    
    			List<DrivingRouteLine> routeLines = result.getRouteLines();
    			List<DrivingStep> steps = routeLines.get(0).getAllStep();
    			// 分为N步
    			for (int i = 0; i < steps.size(); i++) {
    				String instructions = steps.get(i).getInstructions();
    				int direction = steps.get(i).getDirection();
    				int distance = steps.get(i).getDistance();
    				this.distance += distance; // 叠加每一个step的distance
    				String entraceInstructions = steps.get(i)
    						.getEntraceInstructions();
    				String title = steps.get(i).getEntrace().getTitle();
    				stepDetails.add((i + 1) + "." + instructions);
    			}
    
    			needTime = distance / 550;
    
    			// 显示查看路线详情的按钮
    			imageButtonShowDetail.setVisibility(View.VISIBLE);
    			imageButtonShowDetail.setOnClickListener(new OnClickListener() {
    				@Override
    				public void onClick(View v) {
    					// TODO Auto-generated method stub
    					// Show路线详情的PopupWindow
    					showPopupWindowFour("驾车方案",
    							MapUtil.distanceFormatter(distance),
    							MapUtil.timeFormatter(needTime));
    
    				}
    			});
    		}
    
    	}

第16行到第21行依旧是在绘制路线之前做的清理工作，它们分别是路线详情、路线的总距离和需要花费的总时间，自然应到在每次绘制新路线之前重置。第23行通过DrivingRouteResult的getRouteLines()得到所有的规法方案（方案往往不止一种，比如：最短时间的方案、最短距离的方案、少走高速的方案等等），由于我们集成的服务没必要细化到这种程度，所以通过get(0)获取到默认的方案即可。  
  
第24行是一个关键点，体现了**Part D**的内容。在百度地图SDK中，提供了一个用于显示和管理多个覆盖物的类——OverlayManager，同样的它的直接子类有DrivingRouteOverlay, TransitRouteOverlay,WalkingRouteOverlay。所以我们如果要在地图是绘制出路线的Overlay，那么无疑是要通过OverlayManager的这些子类去实现的。可是我们在24行看到的是newMyDrivingRouteOverlay(mBaiduMap)而不是DrivingRouteOverlay，那么没错，这个类也是我们自己定制的。那么自定义的DrivingRouteOverlay究竟能做些什么呢，我们打开官方给出的API可以发现：

![SouthEast][]

文档中写的很清楚重写这些方法分别能干什么了，那么我们根据需求去重写它们即可：

![SouthEast 1][]

如果不需要上面的这些功能就直接去new一个DrivingRouteOverlay即可，下面贴出我的自定义类——MyDrivingRouteOverlay，很简单，只是修改了路线起点和终点的图标而已：

// 定制DrivingRouteOverly
    	private class MyDrivingRouteOverlay extends DrivingRouteOverlay {
    
    		public MyDrivingRouteOverlay(BaiduMap baiduMap) {
    			super(baiduMap);
    		}
    
    		@Override
    		public BitmapDescriptor getStartMarker() {
    			if (useDefaultIcon) {
    				return BitmapDescriptorFactory.fromResource(R.drawable.icon_st);
    			}
    			return null;
    		}
    
    		@Override
    		public BitmapDescriptor getTerminalMarker() {
    			if (useDefaultIcon) {
    				return BitmapDescriptorFactory.fromResource(R.drawable.icon_en);
    			}
    			return null;
    		}
    	}

第29行到31行完成了在地图上绘制路线的Overlay，即**Part E**需要完成的工作。

在这里注意一下27行，我重新设置了一遍OnMarkerListener，这样做的原因就是绘制出来的路线上存在RouteNode，即路线上的节点，如果不重写DrivingRouteOverlay的onMarkerClick方法或者onRuteNodeClick方法，那么点击节点的时候就会触发BaiduMap的OnMarkerClickListener，这样节点的点击和我们大头针的点击事件就会冲突，很明显一般情况下都是需要区分的。所以有以下两种解决办法：

1.不重写任何方法，在BaiduMap的OnMarkerClickListener中做判断，根据RouteNode和我们的自定义Marker区分开处理即可（也就是我在上一篇blog中说到的路线节点，我是通过setTitle来区分的）。

2.重写DrivingRouteOverlay的onMarkerClick方法或onRuteNodeClick方法即可。

最后绘制完路线，我们需要做的就很明显了——查看详情。根据需求我们需要展示每一个Step的详细信息、整体Route的距离以及需要花费的时间。通过官方文档可以清楚的看到，DrivingRouteLine的父类RouteLine提供了一个方法来获取所有的路段——getAllStep()，返回该条路线的所有路段集合——List<DrivingStep>，如37行所示。最后遍历List<DrivingStep>，根据情况封装数据，最后在ListView中展示即可。当然除了每一个路段的详情，还需要计算总距离和总时间，这个也是模仿百度地图的详情页面做的，下面就简单的谈一下关于总距离和总时间的计算问题。

**Part F.**

**距离计算**

计算距离有两种方法，第一种是通过调用DrivingRouteLine的父类RouteLine提供的getDistance()方法即可得到一条路线的距离，返回值为int类型，单位是米。第二种方法是在循环中去叠加每一个Step的distance即可，需要注意的就是每次计算距离之前都要重置distance，很明显第一种简单一些，我这里用的是第二种方法。

参考百度地图的做法，当一条路线的距离小于1公里时，在详情页显示XX米；当一条路线的距离大于1公里时，则显示XX公里XX米，小数点后保留1位。格式转换写了一个小小的工具类，仅供参考：

// 距离转换
    	public static String distanceFormatter(int distance) {
    		if (distance < 1000) {
    			return distance + "米";
    		} else if (distance % 1000 == 0) {
    			return distance / 1000 + "公里";
    		} else {
    			DecimalFormat df = new DecimalFormat("0.0");
    			int a1 = distance / 1000; // 十位
    
    			double a2 = distance % 1000;
    			double a3 = a2 / 1000; // 得到个位
    
    			String result = df.format(a3);
    			double total = Double.parseDouble(result) + a1;
    			return total + "公里";
    		}
    	}

**时间计算**

说到时间计算，那么首先得到的应该是速度，通过距离/速度才能得到时间，关于速度这个东西我参考百度地图做了一组测试，在三环以内（因为高速的话速度肯定不一样，这里只计算市区）随机采集10公里左右的两个点，分别查询驾车、公交、步行所需要的时间，然后通过距离除速度的方式算出距离，依次类推，做了5组测试数据，最终取了平均值得到以下的结果：

**步行1分钟 0.06公里  
驾车1分钟 0.55公里  
公交1分钟 0.15公里**

当然这组数据不一定很精确，不过经过实际测试发现误差也在容忍范围之内。有了距离和速度就好办了，看50行，通过距离/速度最终得到了一条路线所需要耗费的时间。参考百度地图，时间小于60分钟时显示XX分钟，时间大于60分钟时显示XX小时XX分钟，所有这里自然也需要格式转换一下，下面是转换方法：

// 时间转换
    	public static String timeFormatter(int minute) {
    		if (minute < 60) {
    			return minute + "分钟";
    		} else if (minute % 60 == 0) {
    			return minute / 60 + "小时";
    		} else {
    			int hour = minute / 60;
    			int minute1 = minute % 60;
    			return hour + "小时" + minute1 + "分钟";
    		}
    
    	}

最后就是把路线详情（包括距离、时间和所有路段的ListView）展示在一个PopupWindow上就结束了，看一下模拟器的运行效果图（模拟器问题比较多，路线没画出来，不过整体流程没问题，后面会贴真机的运行截图）：

![20141114153343713][]

下面就是真机操作截图，首先点击红色圆圈的Marker弹出下面的PopupWindow，再点击”到这去“，弹出上面的PopupWindow并自动填充起点和终点的位置信息。

![SouthEast 2][]![SouthEast 3][]![SouthEast 4][]

加载完毕后生成路线图：

![SouthEast 5][]

点击右侧的详情按钮可以查看详情，点击垃圾桶图标可以删除路线。

下面是同一条路线的三种不同规划的详情界面，分别是驾车、公交和步行：

![SouthEast 6][]![SouthEast 7][]![SouthEast 8][]

三、总结

写到这里基本就已经完成了我们集成的LBS服务的所有功能，后面可能还需要加入离线地图，可以使用户在没有网络的情况下使用地图服务，这个我就不做记录了，鸿洋大神已经写过了离线地图的blog。我使用的版本是3.1.1，在上周五才更新了3.2.0，增加了热力图的相关功能，由于我们项目暂时用不到就不做过多的介绍了。百度地图SDK从接触到现在也有一周时间了，总的来说收获不小，官方API、示例Demo都很到位，在模仿百度地图的过程中我也感觉自己进步了许多，作为一个Android新手还需要更多的学习才行，我相信只要肯坚持、能吃苦，那么就没有实现不了的功能！继续努力，加油，Raito！

[http_blog.csdn.net_wlwlwlwl015_article_details_41091099]: http://blog.csdn.net/wlwlwlwl015/article/details/41091099
[LBS]: http://blog.csdn.net/wlwlwlwl015/article/details/41076537
[LBS_ Part1]: http://blog.csdn.net/wlwlwlwl015/article/details/41247455
[20141114104533314]: /images/20220810/67e48aa160454f61afb8d83a85a81ad8.png
[SouthEast]: /images/20220810/9ceca88e9ab349a2b19585a592dda5a8.png
[SouthEast 1]: /images/20220810/c44e689792814d0bb5b5d8d14a8a98b4.png
[20141114153343713]: /images/20220810/26d384e0e009438abcc511b3deda5194.png
[SouthEast 2]: https://img-blog.csdn.net/20141114160159312?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvd2x3bHdsd2wwMTU=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[SouthEast 3]: https://img-blog.csdn.net/20141114160042656?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvd2x3bHdsd2wwMTU=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[SouthEast 4]: /images/20220810/1f88b9c9b17b4f1a9fa2ac1b42860b66.png
[SouthEast 5]: /images/20220810/c92ded8d02d4461fb0cfb4200be7e2fc.png
[SouthEast 6]: https://img-blog.csdn.net/20141114161028746?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvd2x3bHdsd2wwMTU=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[SouthEast 7]: https://img-blog.csdn.net/20141114161152062?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvd2x3bHdsd2wwMTU=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[SouthEast 8]: /images/20220810/04d984ecfc874ac79c2f50e6be705aca.png