搜尋服務

百度地圖移動版API整合搜尋服務包括：位置檢索、周邊檢索、範圍檢索、公交檢索、駕乘檢索、步行檢索，通過初始化MKSearch類，註冊搜尋結果的監聽物件MKSearchListener，實現非同步搜尋服務。首先自定義MySearchListener實現MKSearchListener介面，通過不同的回撥方法，獲得搜尋結果：

1. public class MySearchListener implements MKSearchListener {
2. @Override
3. public void onGetAddrResult(MKAddrInfo result, int iError)
   {
4. }
5. @Override
6. public void onGetDrivingRouteResult(MKDrivingRouteResult result, int iError) {
7. }
8. @Override
9. public void onGetPoiResult(MKPoiResult result, int type, int iError) {
10. }
11. @Override
12. public void onGetTransitRouteResult(MKTransitRouteResult result, int iError) {
13. }
14. @Override
15. public void onGetWalkingRouteResult(MKWalkingRouteResult result, int iError) {
16. }
17. @Override
18. public void onGetBusDetailResult(MKBusLineResult result, int iError) {
19. }
20. @Override
21. public void onGetSuggestionResult(MKSuggestionResult result, int iError) {
22. }
23. }

然後初始化MKSearch類:

1. mMKSearch =
   new MKSearch();
2. mMKSearch.init(mBMapMan, new MySearchListener());//注意，MKSearchListener只支援一個，以最後一次設定為準

POI搜尋及PoiOverlay

POI搜尋有三種方式，根據範圍和檢索詞發起範圍檢索poiSearchInbounds，城市poi檢索poiSearchInCity，周邊檢索poiSearchNearBy，以下以周邊檢索為例介紹如何進行檢索並顯示覆蓋物PoiOverlay：

檢索天安門周邊5000米之內的KFC餐廳：

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

實現MySearchListener的onGetPoiResult，並展示檢索結果：

1. @Override
2. public void onGetPoiResult(MKPoiResult result, int type, int iError) {
3. if (result == null) {
4. return;
5. }
6. PoiOverlay poioverlay = new PoiOverlay(MyMapActivity.this, mMapView);
7. poioverlay.setData(result.getAllPoi());
8. mMapView.getOverlays().add(poioverlay);
9. mMapView.invalidate(); //重新整理地圖
10. }

執行結果如下：

place詳情頁面使用方法

當執行完poi檢索後,我們會得到一個poi的列表,每個poi節點都有個uid屬性,我們可以根據這個uid獲取關於這個poi的一些更詳細的資訊.比如：評論、圖片、商戶描述等。

在AndroidManifest.xml中設定如下資訊：

<activity android:name="com.baidu.mapapi.PlaceCaterActivity"
          android:configChanges="orientation|keyboardHidden"
          android:theme="@android:style/Theme.NoTitleBar"> </activity>

發起請求：

mSearch.poiDetailSearch(poi.uid);

詳情頁執行結果：

具體實現詳見相關下載提供的Demo（PoiSearch.java）

駕車路線搜尋及RouteOverlay

檢索從天安門到百度大廈的駕車路線：

1. MKPlanNode start = new MKPlanNode();
2. start.pt = new GeoPoint((int) (39.915 * 1E6), (int) (116.404 * 1E6));
3. MKPlanNode end = new MKPlanNode();
4. end.pt = new GeoPoint(40057031, 116307852);
5. // 設定駕車路線搜尋策略，時間優先、費用最少或距離最短
6. mMKSearch.setDrivingPolicy(MKSearch.ECAR_TIME_FIRST);
7. mMKSearch.drivingSearch(null, start, null, end);

實現MySearchListener的onGetDrivingRouteResult，並展示檢索結果：

1. @Override
2. public void onGetDrivingRouteResult(MKDrivingRouteResult result, int iError) {
3. if (result == null) {
4. return;
5. }
6. RouteOverlay routeOverlay = new RouteOverlay(MyMapActivity.this, mMapView);
7. // 此處僅展示一個方案作為示例
8. routeOverlay.setData(result.getPlan(0).getRoute(0));
9. mMapView.getOverlays().add(routeOverlay);
10. }

執行結果如下：

步行路線搜尋及RouteOverlay

方式與駕車路線搜尋類似，只需將mMKSearch.drivingSearch(null, start, null, end)修改為mMKSearch.walkingSearch(null, start, null, end),實現的方法改為onGetWalkingRouteResult即可，不再贅述。

公交換乘路線搜尋及TransitOverlay

檢索從天安門到百度大廈的公交換乘路線：

1. MKPlanNode start = new MKPlanNode();
2. start.pt = new GeoPoint((int) (39.915 * 1E6), (int) (116.404 * 1E6));
3. MKPlanNode end = new MKPlanNode();
4. end.pt = new GeoPoint(40057031, 116307852);
5. // 設定乘車路線搜尋策略，時間優先、最少換乘、最少步行距離或不含地鐵
6. mMKSearch.setTransitPolicy(MKSearch.EBUS_TRANSFER_FIRST);
7. mMKSearch.transitSearch("北京", start, end); // 必須設定城市名

實現MySearchListener的onGetTransitRouteResult(MKTransitRouteResult, int)，並展示檢索結果：

1. @Override
2. public void onGetTransitRouteResult(MKTransitRouteResult result, int iError) {
3. if (result == null) {
4. return;
5. }
6. TransitOverlay transitOverlay = new TransitOverlay(MyMapActivity.this, mMapView);
7. // 此處僅展示一個方案作為示例
8. transitOverlay.setData(result.getPlan(0));
9. mMapView.getOverlays().add(transitOverlay);
10. mMapView.invalidate(); //重新整理地圖
11. }

公交路線詳情搜尋

檢索北京市公交路線717的poi，獲取公交路線的uid：

1. mSearch.poiSearchInCity("北京", "717");

實現MySearchListener的onGetPoiResult (MKPoiResult res, int type, int error)，獲得公交線路poi的uid，並根據此uid發起公交線路詳情的檢索：

1. @Override
2. public void onGetPoiResult(MKPoiResult res, int type, int error) {
3. // 錯誤號可參考MKEvent中的定義
4. if (error != 0 || res == null) {
5. Toast.makeText(BusLineSearch.this, "抱歉，未找到結果", Toast.LENGTH_LONG).show();
6. return;
7. }
8. // 找到公交路線poi node
9. MKPoiInfo curPoi = null;
10. int totalPoiNum = res.getNumPois();
11. for( int idx = 0; idx < totalPoiNum; idx++ ) {
12. curPoi = res.getPoi(idx);
13. if ( 2 == curPoi.ePoiType ) {
14. break;
15. }
16. }
17. mSearch.busLineSearch(mCityName, curPoi.uid);
18. }

實現MySearchListener的onGetBusDetailResult(MKBusLineResult result, int iError)，並展示搜尋結果：

1. public void onGetBusDetailResult(MKBusLineResult result, int iError) {
2. if (iError != 0 || result == null) {
3. Toast.makeText(BusLineSearch.this, "抱歉，未找到結果", Toast.LENGTH_LONG).show();
4. return;
5. }
6. RouteOverlay routeOverlay = new RouteOverlay(BusLineSearch.this, mMapView);
7. // 此處僅展示一個方案作為示例
8. routeOverlay.setData(result.getBusRoute());
9. mMapView.getOverlays().clear();
10. mMapView.getOverlays().add(routeOverlay);
11. mMapView.invalidate();
12. mMapView.getController().animateTo(result.getBusRoute().getStart());
13. }

執行結果如下：

地址資訊查詢

根據地理座標查詢地址資訊：

1. mMKSearch.reverseGeocode(new GeoPoint(40057031, 116307852)); //逆地址解析
2. mMKSearch.geocode(key, city);//地址解析

geocode返回結果在MKSearchListener裡的onGetAddrResult方法。

reverseGeocode返回結果在MKSearchListener裡的onGetPoiResult方法。

1. public void onGetAddrResult(MKAddrInfo res, int error) {
2. if (error != 0) {
3. String str = String.format("錯誤號：%d", error);
4. Toast.makeText(GeoCoder.this, str, Toast.LENGTH_LONG).show();
5. return;
6. }
7. mMapView.getController().animateTo(res.geoPt);
8. String strInfo = String.format("緯度：%f 經度：%f\r\n", res.geoPt.getLatitudeE6()/1e6,res.geoPt.getLongitudeE6()/1e6);
9. Toast.makeText(GeoCoder.this, strInfo, Toast.LENGTH_LONG).show();
10. Drawable marker = getResources().getDrawable(R.drawable.iconmarka); //得到需要標在地圖上的資源
11. marker.setBounds(0, 0, marker.getIntrinsicWidth(), marker.getIntrinsicHeight()); //為maker定義位置和邊界
12. mMapView.getOverlays().clear();
13. mMapView.getOverlays().add(new OverItemT(marker, GeoCoder.this, res.geoPt, res.strAddr));
14. }

1. public void onGetPoiResult(MKPoiResult res, int type, int error) {
2. if (error != 0 || res == null) {
3. Toast.makeText(GeoCoder.this, "解析失敗", Toast.LENGTH_LONG).show();
4. return;
5. }
6. if (res != null && res.getCurrentNumPois() > 0) {
7. GeoPoint ptGeo = res.getAllPoi().get(0).pt;
8. // 移動地圖到該點：
9. mMapView.getController().animateTo(ptGeo);
10. String strInfo = String.format("緯度：%f 經度：%f\r\n", ptGeo.getLatitudeE6()/1e6,ptGeo.getLongitudeE6()/1e6);
11. strInfo += "\r\n附近有：";
12. for (int i = 0; i < res.getAllPoi().size(); i++) {
13. strInfo += (res.getAllPoi().get(i).name + ";");
14. }
15. Toast.makeText(GeoCoder.this, strInfo, Toast.LENGTH_LONG).show();
16. }
17. }

線上建議查詢

根據關鍵詞查詢線上建議詞：

1. mMKSearch.suggestionSearch("天安門"); //輸入關鍵詞

實現MySearchListener的onGetSuggestionResult，得到查詢結果：

1. ListView mSuggestionList = (ListView) findViewById(R.id.listView1);
2. @Override
3. public void onGetSuggestionResult(MKSuggestionResult res, int iError)
4. {
5. if (iError!= 0 || res == null) {
6. Toast.makeText(PoiSearch.this, "抱歉，未找到結果", Toast.LENGTH_LONG).show();
7. return;
8. }
9. int nSize = res.getSuggestionNum();
10. String[] mStrSuggestions = new String[nSize];
11. for (int i = 0; i < nSize; i++)
12. {
13. mStrSuggestions[i] = res.getSuggestion(i).city + res.getSuggestion(i).key;
14. }
15. ArrayAdapter<String> suggestionString = new ArrayAdapter<String>(PoiSearch.this, android.R.layout.simple_list_item_1,mStrSuggestions);
16. mSuggestionList.setAdapter(suggestionString);
17. }

雲檢索模組的使用

首先例項化GeoSearchListener介面：

1. @Override
2. public void onGetGeoDetailsResult(DetailResult result, int type, int iError)
3. {
4. if (result != null) {
5. if (result.content != null) {
6. Toast.makeText(CloudSearchDemo.this, result.content.name, Toast.LENGTH_LONG).show();
7. }
8. else {
9. Toast.makeText(CloudSearchDemo.this, "status:" + result.status, Toast.LENGTH_SHORT).show();
10. }
11. }
12. }
13. @Override
14. public void onGetGeoResult(GeoSearchResult result, int type, int iError)
15. {
16. if (result != null && result.poiList != null && result.poiList.size() > 0) {
17. CloudOverlay poiOverlay = new CloudOverlay(this);
18. poiOverlay.setData(result.poiList);
19. mMapView.getOverlays().clear();
20. mMapView.getOverlays().add(poiOverlay);
21. mMapView.invalidate();
22. mMapView.getController().animateTo(new GeoPoint((int)(result.poiList.get(0).latitude * 1e6), (int)(result.poiList.get(0).longitude * 1e6)));
23. }
24. }

發起雲檢索請求：

1. BoundsSearchInfo r = new BoundsSearchInfo();
2. r.queryWords = "五中";
3. r.ak = "輸入你的ak";
4. r.bounds = new Bounds(39843895, 116402214, 40956948, 116431457);
5. r.filter.put("databox", 848);
6. r.scope = 2;
7. GeoSearchManager.getInstance().searchBounds(r);
8. // 當請求成功時，會回撥onGetGeoResult函式，執行打點操作。
9. CloudOverlay poiOverlay = new CloudOverlay(this);
10. poiOverlay.setData(result.poiList);
11. mMapView.getOverlays().clear();
12. mMapView.getOverlays().add(poiOverlay);
13. mMapView.invalidate();

執行結果如下：