jbzhang99 / android_usingcar_example

基于高德地图Android API快速搭建用车解决方案的示例

Android_UsingCar_Example

基于高德地图Android API快速搭建用车解决方案的示例

##出行类解决方案——乘客端 搭建出行类用车乘客端的LBS部分，仅需要以下三步： ###Step 1：定位+逆地理编码+地图打点，搞定前端展示 效果如下图。屏幕中间的蓝色标记 用到了定位功能。位于顶部的输入框 用到了逆地理编码功能；地图上蓝色的出租车标识 运用了地图打点。
###定位 需要做的仅仅是将libs下的库拷贝到你的工程中，打开高小德用车的源代码，将LocationTask.java拷贝到工程中，找到MainActivity.java文件，仿照其中的写法，在合适的位置调用如下这几行，即可调起定位功能。

private LocationTask mLocationTask;//声明定位对象
mLocationTask = LocationTask.getInstance(getApplicationContext());//获取定位单例
mLocationTask.setOnLocationGetListener(locationTaskListener);//设置监听器
mLocationTask.startSingleLocate();//开始定位
mLocationTask.onDestroy();//销毁定位资源

###逆地理编码

先行将RegeocodeTask.java拷贝到工程中，依旧参照MainActivity.java文件，在合适的位置调用如下的代码段，即可调起逆地理编码功能。

private RegeocodeTask mRegeocodeTask;//声明逆地理编码对象
mRegeocodeTask = new RegeocodeTask(getApplicationContext());//为该对象赋值
mRegeocodeTask.setOnLocationGetListener(regeocodeTaskListener);//设置监听器
mRegeocodeTask.search(mPosition.latitude, mPosition.longitude);//启动逆地理编码服务

###地图打点

Utils.java封装了在地图上打点的功能，如下调用即可。

Utils.addEmulateData(mAmap, mStartPosition);//调用addEmulateData方法。参数解释：参数一为地图的controller；参数二为模拟数据的中心点，真实数据可以传递数据列表。

###Step 2 输入提示+POI搜索，搞定目的地 完成了以上这三大要点之后，接下来需要告诉司机师傅乘客要去哪里了。如下图所示，为了给用户提供一个更好的用车体验，在支持录入目的地的功能基础上，提供输入提示+POI搜索功能，进一步提升体验。

###输入提示

拷贝InputTipTask.java到创建的工程中，查看DestinationActivity.java示例，实现TextWatcher接口后，进行如下调用：

@Override//在onTextChanged方法中调用InputTipTask 的getInstance方法
	public void onTextChanged(CharSequence s, int start, int before, int count) {
	InputTipTask.getInstance(getApplicationContext(),
mRecomandAdapter).searchTips(s.toString(),
			   RouteTask.getInstance(getApplicationContext()).getStartPoint().city);
	}

输入提示功能完成！

###POI搜索

拷贝PoiSearchTask.java到创建的工程中，参考DestinationActivity.java调用核心方法的方式，即可实现如图所示的POI搜索。核心方法如下：

PoiSearchTask poiSearchTask=new PoiSearchTask(getApplicationContext(),
mRecomandAdapter);//生成poiSearchTask对象
poiSearchTask.search(mDestinaionText.getText().toString(),RouteTask.getInstance(getApplicationContext()).getStartPoint().city);//开始进行POI搜索

###Step 3 驾车路径规划，搞定费用预估

驾车路径规划功能提供了费用预估功能，效果参照下图

###驾车路径规划

拷贝RouteTask.java文件到创建的工程中，参照MainActivity.java文件中的示例代码，实现OnRouteCalculateListener接口。调用的核心方法如下：

	@Override //OnRouteCalculateListener提供的onRouteCalculate回调函数，高小德用车已经将返回onRouteCalculate结果的代码完整封装
	public void onRouteCalculate(float cost,float distance,int duration) {
		mDestinationContainer.setVisibility(View.VISIBLE);
	
		mRouteCostText.setVisibility(View.VISIBLE);
		mDesitinationText.setText(RouteTask
				.getInstance(getApplicationContext()).getEndPoint().address);
		mRouteCostText.setText(
				String.format("预估费用%.2f元，距离%.1fkm,用时%d分", cost,distance,duration)
				 );
		mDestinationButton.setText("我要用车");
		mCancelButton.setVisibility(View.VISIBLE);
		mDestinationButton.setOnClickListener(null);
	}