Android版本百度地图开发（二）——图层和检索

通过上面一章我们已经了解到如何进行基本的地图应用开发，接下来的都是属于应用方面的技巧。本章主要讲解图层和检索服务。

2 地图图层

图层包括底图、交通图和卫星图。我们正常情况下看到的就是底图，可以通过mapView控制显示交通图和卫星图。

		// 显示交通图
		mMapView.setTraffic(true);
		
		// 显示卫星图
//		mMapView.setSatellite(true);

3 检索服务

3.1 搜索框架

搜索包括位置检索、周边检索、范围检索、公交检索、驾乘检索、步行检索、短串分享，需要创建一个MKSearch对象进行搜索。

我们首先创建一个搜索类：

package com.demo.baidumap;

import com.baidu.mapapi.search.MKAddrInfo;
import com.baidu.mapapi.search.MKBusLineResult;
import com.baidu.mapapi.search.MKDrivingRouteResult;
import com.baidu.mapapi.search.MKPoiResult;
import com.baidu.mapapi.search.MKSearchListener;
import com.baidu.mapapi.search.MKShareUrlResult;
import com.baidu.mapapi.search.MKSuggestionResult;
import com.baidu.mapapi.search.MKTransitRouteResult;
import com.baidu.mapapi.search.MKWalkingRouteResult;

public class MySearchListener implements MKSearchListener {

	@Override
	public void onGetAddrResult(MKAddrInfo arg0, int arg1) {
		// TODO Auto-generated method stub

	}

	@Override
	public void onGetBusDetailResult(MKBusLineResult arg0, int arg1) {
		// TODO Auto-generated method stub

	}

	@Override
	public void onGetDrivingRouteResult(MKDrivingRouteResult arg0, int arg1) {
		// TODO Auto-generated method stub

	}

	@Override
	public void onGetPoiDetailSearchResult(int arg0, int arg1) {
		// TODO Auto-generated method stub

	}

	@Override
	public void onGetPoiResult(MKPoiResult arg0, int arg1, int arg2) {
		// TODO Auto-generated method stub

	}

	@Override
	public void onGetShareUrlResult(MKShareUrlResult arg0, int arg1, int arg2) {
		// TODO Auto-generated method stub

	}

	@Override
	public void onGetSuggestionResult(MKSuggestionResult arg0, int arg1) {
		// TODO Auto-generated method stub

	}

	@Override
	public void onGetTransitRouteResult(MKTransitRouteResult arg0, int arg1) {
		// TODO Auto-generated method stub

	}

	@Override
	public void onGetWalkingRouteResult(MKWalkingRouteResult arg0, int arg1) {
		// TODO Auto-generated method stub

	}

}

在我们的Activity中定义一个成员变量：

private MKSearch mMKSearch = null;

在Activity的onCreate中初始化MKSearch变量：

		// 初始化搜索变量
		mMKSearch = new MKSearch();
		mMKSearch.init(mBMapMan, new MySearchListener());

根据文档的说明，还需要在Activity的onDestroy中销毁搜索变量：

		mMKSearch.destory();

这样，我们就可以在需要的地方使用搜索了：

3.2 兴趣点搜索

兴趣点的搜索主要还是集中于输入的关键字上：

3.2.1 范围检索

范围检索顾名思义是给定一个范围和关键字的搜索，这里的范围是通过两个点确定的矩形区域。代码是这样的：

				// 北京西站
				GeoPoint ptLB = new GeoPoint( (int)(39.901375 * 1E6),(int)(116.329099 * 1E6)); 
				// 北京北站
				GeoPoint ptRT = new GeoPoint( (int)(39.949404 * 1E6),(int)(116.360719 * 1E6));
				mMKSearch.poiSearchInbounds("KFC", ptLB, ptRT);

3.2.2 城市搜索

城市搜索需要输入城市名和搜索关键字：

				mMKSearch.poiSearchInCity("北京", "KFC"); 

3.2.3 周边搜索

周边搜索需要输入关键字、搜索点和搜索半径：

mMKSearch.poiSearchNearBy("KFC", new GeoPoint((int) (39.915 * 1E6), (int) (116.404 * 1E6)), 5000);

3.2.4 搜索结果

搜索结果是异步回调，对于兴趣点搜索保存在onGetPoiResult中：

	@Override
	public void onGetPoiResult(MKPoiResult res, int type, int error) {
		// 错误号可参考MKEvent中的定义
		if (error == MKEvent.ERROR_RESULT_NOT_FOUND) {
			System.out.println("抱歉，未找到结果");
			return;
		} else if (error != 0 || res == null) {
			System.out.println("搜索出错啦..");
			return;
		}
		// 将poi结果显示到地图上
		PoiOverlay poiOverlay = new PoiOverlay(activity, mapView);
		poiOverlay.setData(res.getAllPoi());
		mapView.getOverlays().clear();
		mapView.getOverlays().add(poiOverlay);
		mapView.refresh();
		// 当ePoiType为2（公交线路）或4（地铁线路）时， poi坐标为空
		for (MKPoiInfo info : res.getAllPoi()) {
			if (info.pt != null) {
				mapView.getController().animateTo(info.pt);
				break;
			}
		}
	}

3.3 地址信息查询

3.3.1 根据坐标查询地址

mMKSearch.reverseGeocode(new GeoPoint(31240252, 121496944)); // 通过坐标查询地址

3.3.2 根据地址查询坐标

mMKSearch.geocode("东方明珠", "上海");// 通过地址查询坐标

3.3.3 回调处理

	@Override
	public void onGetAddrResult(MKAddrInfo res, int error) {
		if (error != 0) {
			String str = String.format("错误号：%d", error);
			Toast.makeText(activity, str, Toast.LENGTH_LONG).show();
			return;
		}
		//地图移动到该点
		mapView.getController().animateTo(res.geoPt);
		
		if (res.type == MKAddrInfo.MK_GEOCODE) {
			//地理编码：通过地址检索坐标点
			String strInfo = String.format("纬度：%f 经度：%f", res.geoPt.getLatitudeE6()/1e6, res.geoPt.getLongitudeE6()/1e6);
			Toast.makeText(activity, strInfo, Toast.LENGTH_LONG).show();
		}
		if (res.type == MKAddrInfo.MK_REVERSEGEOCODE) {
			//反地理编码：通过坐标点检索详细地址及周边poi
			String strInfo = res.strAddr;
			Toast.makeText(activity, strInfo, Toast.LENGTH_LONG).show();
		}
	}

3.4 在线建议查询

在线建议是指用户输入一个关键字，系统自动匹配的搜索结果列表。

3.4.1 搜索

搜索执行代码：

				mMKSearch.suggestionSearch("东方明珠", "上海");

3.4.2 搜索结果

搜索结果处理使用：

	@Override
	public void onGetSuggestionResult(MKSuggestionResult res, int err) {
		if (err!= 0 || res == null) {  
            Toast.makeText(activity, "抱歉，未找到结果", Toast.LENGTH_LONG).show();   
            return;  
        }  
        int nSize = res.getSuggestionNum();  
        for (int i = 0; i <nSize; i++){  
           System.out.println(res.getSuggestion(i).city + res.getSuggestion(i).key);  
        }  
	}

3.5 短串分享

短串是指搜索结果对应一个很短的链接，用户分享这个链接后别人可以打开这个链接访问搜索结果。目前百度地图开放的是“POI点分享”和“反Geo分享”。

3.5.1 POI点分享

根据POI结果的uid，可以生成一个短链接用于分享，由于目前我们尚未讲到POI，所以这里仅给出一个示例，后续讲解如何得到一个POI：

				MKPoiInfo poi = new MKPoiInfo();
				mMKSearch.poiDetailShareURLSearch(poi.uid);

3.5.2 反Geo点分享

				/*
				 * 发起地址信息短串请求，一个位置的地理信息一可以通过GeoCode/反GeoCode搜索获得. mSearch 为
				 * MKSearch象， 参数pt为要分享的位置的经纬度坐标
				 * ，name和addr为百度地图客户端在展示该位置时显示的名称和地址.
				 */
				GeoPoint pt = new GeoPoint((int) (31.240252 * 1E6),
						(int) (121.496944 * 1E6));
				String name = "东方明珠";
				String addr = "世纪大道1号";
				mMKSearch.poiRGCShareURLSearch(pt, name, addr);

3.5.3 搜索结果

	@Override
	public void onGetShareUrlResult(MKShareUrlResult result, int type, int error) {
		if (error != 0) {
			// 错误码不为0，表示搜索错误
			return;
		}
		if (type == MKEvent.MKEVENT_POIDETAILSHAREURL) {
			// 返回poi详情短串
			Log.d("baidumapsdk", result.url);
		}
		if (type == MKEvent.MKEVENT_POIRGCSHAREURL) {
			// 返回地址信息短串
			Log.d("baidumapsdk", result.url);
		}
	}