本文主要講解如何通過百度地圖API搜尋得到一個城市裡的所有POI。這裡有必要對“所有”這個詞進行強調一下，以便引起重視，之所以這樣說，是因為在搜尋POI時，預設僅返回一頁的搜尋結果10條，那麼如何才能得到所有的搜尋結果呢？其實baidu map api是提供了相關的方法，但我發現有相當多的網友都在問這個問題，所以有必要講解演示一下。
      先講一下什麼稱之為“城市POI搜尋”？它與我們在上一篇文章（[011] 百度地圖API之POI搜尋-發現你身邊的興趣點，如超市、餐廳、ATM...(Android)）中瞭解到的POI搜尋有什麼區別呢？
      上一篇文章中所呼叫的是地圖API的“周邊POI搜尋”服務，即檢索周圍多少米以內的POI；而本章所要呼叫的是地圖API的“城市POI搜尋”服務，即檢索某個城市中所有的POI。如果你看完這兩篇文章後，你會發現僅僅是呼叫的方法不同而以，搜尋結果的處理方法是同一個方法，搜尋結果的處理程式碼也是完全一樣的。

      下面將給出城市POI搜尋的一個完整示例，並且會講解如何才能獲取到所有的搜尋結果。
1）佈局檔案res/layout/poi_city_search.xml
      <?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent" > <com.baidu.mapapi.MapView android:id="@+id/map_View" android:layout_width="fill_parent" android:layout_height="fill_parent" android:clickable="true" /> <LinearLayout android:orientation="horizontal" android:layout_width="fill_parent" android:layout_height="wrap_content" android:layout_alignTop="@id/map_View" android:layout_alignLeft="@id/map_View" android:layout_alignRight="@id/map_View" android:background="@null" android:padding="0dip" > <EditText android:id="@+id/keyword_edittext" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_gravity="center_vertical" android:layout_weight="20" /> <Button android:id="@+id/query_button" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_gravity="center_vertical" android:layout_weight="1" android:text="搜尋" /> </LinearLayout> </RelativeLayout>
2）繼承了com.baidu.mapapi.MapActivity的Activity類
      package com.liufeng.baidumap; import android.app.AlertDialog; import android.content.DialogInterface; import android.os.Bundle; import android.view.View; import android.view.View.OnClickListener; import android.widget.Button; import android.widget.EditText; import com.baidu.mapapi.BMapManager; import com.baidu.mapapi.MKAddrInfo; import com.baidu.mapapi.MKDrivingRouteResult; import com.baidu.mapapi.MKPoiInfo; import com.baidu.mapapi.MKPoiResult; import com.baidu.mapapi.MKSearch; import com.baidu.mapapi.MKSearchListener; import com.baidu.mapapi.MKTransitRouteResult; import com.baidu.mapapi.MKWalkingRouteResult; import com.baidu.mapapi.MapActivity; import com.baidu.mapapi.MapController; import com.baidu.mapapi.MapView; import com.baidu.mapapi.PoiOverlay; public class PoiSearchInCityActivity extends MapActivity { // 定義地圖引擎管理類 private BMapManager mapManager; // 定義搜尋服務類 private MKSearch mMKSearch; private MapView mapView; private MapController mapController; private EditText keyWordEditText; private Button queryButton; private static StringBuilder sb; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.poi_city_search); // 初始化MapActivity mapManager = new BMapManager(getApplication()); // init方法的第一個引數需填入申請的API Key mapManager.init("285B415EBAB2A92293E85502150ADA7F03C777C4", null); super.initMapActivity(mapManager); mapView = (MapView) findViewById(R.id.map_View); // 設定地圖模式為交通地圖 mapView.setTraffic(true); // 設定啟用內建的縮放控制元件 mapView.setBuiltInZoomControls(true); // 取得地圖控制器物件，用於控制MapView mapController = mapView.getController(); // 設定地圖預設的縮放級別 mapController.setZoom(10); // 設定每頁返回的POI數，預設為10，取值範圍1-50 MKSearch.setPoiPageCapacity(10); // 初始化MKSearch mMKSearch = new MKSearch(); mMKSearch.init(mapManager, new MySearchListener()); keyWordEditText = (EditText) findViewById(R.id.keyword_edittext); queryButton = (Button) findViewById(R.id.query_button); queryButton.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { //每次搜尋前先前sb中的內容清空 sb = new StringBuilder(); String keyWord = keyWordEditText.getText().toString().trim(); // 搜尋貴陽地區的沃爾瑪 mMKSearch.poiSearchInCity("貴陽", keyWord); } }); } @Override protected boolean isRouteDisplayed() { return false; } @Override protected void onDestroy() { if (mapManager != null) { // 程式退出前需呼叫此方法 mapManager.destroy(); mapManager = null; } super.onDestroy(); } @Override protected void onPause() { if (mapManager != null) { // 終止百度地圖API mapManager.stop(); } super.onPause(); } @Override protected void onResume() { if (mapManager != null) { // 開啟百度地圖API mapManager.start(); } super.onResume(); } /** * 實現MKSearchListener介面,用於實現非同步搜尋服務 * * @author liufeng */ public class MySearchListener implements MKSearchListener { /** * 根據經緯度搜索地址資訊結果 * * @param result 搜尋結果 * @param iError 錯誤號（0表示正確返回） */ @Override public void onGetAddrResult(MKAddrInfo result, int iError) { } /** * 駕車路線搜尋結果 * * @param result 搜尋結果 * @param iError 錯誤號（0表示正確返回） */ @Override public void onGetDrivingRouteResult(MKDrivingRouteResult result, int iError) { } /** * POI搜尋結果（範圍檢索、城市POI檢索、周邊檢索） * * @param result 搜尋結果 * @param type 返回結果型別（11,12,21:poi列表 7:城市列表） * @param iError 錯誤號（0表示正確返回） */ @Override public void onGetPoiResult(MKPoiResult result, int type, int iError) { if (result == null) { return; } // 清除地圖上已有的所有覆蓋物 mapView.getOverlays().clear(); // PoiOverlay是baidu map api提供的用於顯示POI的Overlay PoiOverlay poioverlay = new PoiOverlay(PoiSearchInCityActivity.this, mapView); // 設定搜尋到的POI資料 poioverlay.setData(result.getAllPoi()); // 在地圖上顯示PoiOverlay（將搜尋到的興趣點標註在地圖上） mapView.getOverlays().add(poioverlay); if(result.getNumPois() > 0) { // 設定其中一個搜尋結果所在地理座標為地圖的中心 MKPoiInfo poiInfo = result.getPoi(0); mapController.setCenter(poiInfo.pt); } sb.append("共搜尋到").append(result.getNumPois()).append("個POI/n"); // 遍歷當前頁返回的POI（預設只返回10個） for (MKPoiInfo poiInfo : result.getAllPoi()) { sb.append("名稱：").append(poiInfo.name).append("/n"); //sb.append("地址：").append(poiInfo.address).append("/n"); //sb.append("經度：").append(poiInfo.pt.getLongitudeE6() / 1000000.0f).append("/n"); //sb.append("緯度：").append(poiInfo.pt.getLatitudeE6() / 1000000.0f).append("/n"); } // 通過AlertDialog顯示當前頁搜尋到的POI new AlertDialog.Builder(PoiSearchInCityActivity.this) .setTitle("搜尋到的POI資訊") .setMessage(sb.toString()) .setPositiveButton("關閉", new DialogInterface.OnClickListener() { public void onClick(DialogInterface dialog, int whichButton) { dialog.dismiss(); } }).create().show(); } /** * 公交換乘路線搜尋結果 * * @param result 搜尋結果 * @param iError 錯誤號（0表示正確返回） */ @Override public void onGetTransitRouteResult(MKTransitRouteResult result, int iError) { } /** * 步行路線搜尋結果 * * @param result 搜尋結果 * @param iError 錯誤號（0表示正確返回） */ @Override public void onGetWalkingRouteResult(MKWalkingRouteResult result, int iError) { } } }
3）AndroidManifest.xml中的配置
      <?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.liufeng.baidumap" android:versionCode="1" android:versionName="1.0"> <application android:icon="@drawable/icon" android:label="@string/app_name"> <activity android:name=".PoiSearchInCityActivity" android:label="@string/app_name"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> <uses-sdk android:minSdkVersion="4" /> <!-- 訪問網路的許可權 --> <uses-permission android:name="android.permission.INTERNET" /> <!-- 訪問精確位置的許可權 --> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!-- 訪問網路狀態的許可權 --> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- 訪問WIFI網路狀態的許可權 --> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <!-- 改變WIFI網路狀態的許可權 --> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <!-- 讀寫儲存卡的許可權 --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <!-- 讀取電話狀態的許可權 --> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> </manifest>
4）執行結果
       
程式執行起來後，我們輸入關鍵詞“ktv”進行搜尋，而在程式碼中我們設定了搜尋城市為“貴陽”，即我們要搜尋貴陽市所有的KTV。搜尋完成後，首先會彈出一個對話方塊，如上圖所示，顯示了搜尋到了POI總數及每一個POI名稱，點選“關閉”按鈕後，可以看到搜尋到的ktv所在位置也在地圖上進行了標註。
      到目前為止，一切看起來很正常。然而，真的是這樣嗎？請仔細看上面第一張圖中顯示的搜尋結果數為60，即在貴陽市總共個60家ktv，但是下面卻只顯示了10家ktv名稱，並且第二張圖中地圖中也只標註了10家ktv，這到底是為什麼呢？其它50家ktv結果去哪了？原因是這樣的：
      一次搜尋所得到的POI數有時候可能有成千上萬個，比如你搜索“餐廳”試試，試想如果一次性從百度地圖伺服器上返回上萬條搜尋結果資料到客戶的手機上將會是一種什麼樣的情況？所以百度地圖API對一次性返回的搜尋結果進行了限制--一次性最多隻能返回50條搜尋結果，預設情況下一次性返回10條搜尋結果。我們可以通過下面的方法去改變一次性返回的搜尋結果數：
            // 設定每頁返回的POI數，預設為10，取值範圍1-50
            MKSearch.setPoiPageCapacity(10);
但最大也只能設定為50。那麼怎麼才能一次性得到所有的搜尋結果呢？怎麼才能得到上面示例中的60家ktv的資訊呢？讓我們來改一下上面Activity中處理搜尋結果的方法onGetPoiResult，其實所有程式碼都保持不變。將onGetPoiResult方法內的處理程式碼修改為：
      /** * POI搜尋結果（範圍檢索、城市POI檢索、周邊檢索） * * @param result 搜尋結果 * @param type 返回結果型別（11,12,21:poi列表 7:城市列表） * @param iError 錯誤號（0表示正確返回） */ @Override public void onGetPoiResult(MKPoiResult result, int type, int iError) { if (result == null) { return; } // 清除地圖上已有的所有覆蓋物 mapView.getOverlays().clear(); // PoiOverlay是baidu map api提供的用於顯示POI的Overlay PoiOverlay poioverlay = new PoiOverlay(PoiSearchInCityActivity.this, mapView); // 設定搜尋到的POI資料 poioverlay.setData(result.getAllPoi()); // 在地圖上顯示PoiOverlay（將搜尋到的興趣點標註在地圖上） mapView.getOverlays().add(poioverlay); // 如果當前頁的索引為0，表示第一頁搜尋結果 if(result.getPageIndex() == 0) { sb.append("共搜尋到").append(result.getNumPois()).append("個POI/n"); } // 遍歷當前頁返回的POI（預設只返回10個） for (MKPoiInfo poiInfo : result.getAllPoi()) { sb.append("名稱：").append(poiInfo.name).append("/n"); //sb.append("地址：").append(poiInfo.address).append("/n"); //sb.append("經度：").append(poiInfo.pt.getLongitudeE6() / 1000000.0f).append("/n"); //sb.append("緯度：").append(poiInfo.pt.getLatitudeE6() / 1000000.0f).append("/n"); } if(result.getPageIndex() < result.getNumPages()-1) { mMKSearch.goToPoiPage(result.getPageIndex() + 1); } // 如果是最後一頁，顯示搜尋結果 else if(result.getPageIndex() == result.getNumPages()-1) { // 設定其中一個搜尋結果所在地理座標為地圖的中心 MKPoiInfo poiInfo = result.getPoi(0); mapController.setCenter(poiInfo.pt); // 通過AlertDialog顯示所有搜尋到的POI new AlertDialog.Builder(PoiSearchInCityActivity.this) .setTitle("搜尋到的POI資訊") .setMessage(sb.toString()) .setPositiveButton("關閉", new DialogInterface.OnClickListener() { public void onClick(DialogInterface dialog, int whichButton) { dialog.dismiss(); } }).create().show(); } } 
再來看一下執行結果：
     
怎麼樣？搜尋到的60家ktv資訊一次性全部顯示出來了吧。關鍵在於下面這3行程式碼：
            if(result.getPageIndex() < result.getNumPages()-1) {
                  mMKSearch.goToPoiPage(result.getPageIndex() + 1);
            }
伺服器是以分頁的形式分多次向我們返回搜尋結果的，result.getPageIndex()得到的是當前頁碼（從0開始）。這3行程式碼的含義是：如果當前頁不是最後一頁，那麼就轉到下一頁（goToPoiPage方法是作用是跳轉到搜尋結果的第幾頁），每次呼叫goToPoiPage方法，都會再次觸發搜尋請求，也就會再次回撥執行onGetPoiResult方法；這和網頁中的伺服器端分頁是一個道理，即每次點選“上一頁”、“下一頁”都會再一次提交查詢請求。這也就是為什麼我們要採用static型別的StringBuilder物件來儲存搜尋結果而不是在onGetPoiResult方法中定義一個區域性變數，並且還要在每次點選“搜尋”按鈕後，重新建立一個新的StringBuilder物件來儲存搜尋結果。
      完！