[011] 百度地图API之POI搜索-发现你身边的兴趣点，如超市、餐厅、ATM...(Android)

      本文主要讲解如何通过百度地图API搜索指定位置附近的POI（Point of Interest，兴趣点），如超市、餐厅、ATM、KTV等等。
      虽然在上一篇文章（[010] 百度地图API之根据经纬度查询地址信息(Android) ）中讲到，在根据经纬度查询地址信息的同时，也会获得该地址周围的一些POI，但那些POI具有不确定性（可能是餐厅、银行、酒吧，也有可能是学校、医院、超市），并且很可能都不是我们所感兴趣的地方。
      我想大家可能都有过这样的经历：兜里揣着一张银行卡，在街上到处找自动取款机（ATM）。在这个场景中，ATM就是的兴趣点，我们想做的事情就是找到离自己较近的一些ATM然后取款，此时我们并不关心附近有哪些超市、酒吧，因为这些地方没办法取钱！
      说了这么多，一方面是加深大家对POI这个词的认识，另一方面也是为了让大家明白我们接下来要做的事情。理论性的东西就不再多讲了，直接来看例子。
1）布局文件res/layout/main.xml
     

<?xml version="1.0" encoding="utf-8"?><LinearLayout 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>

2）继承了com.baidu.mapapi.MapActivity的Activity类
     

package com.liufeng.baidumap;import android.os.Bundle;import com.baidu.mapapi.BMapManager;import com.baidu.mapapi.GeoPoint;import com.baidu.mapapi.MKAddrInfo;import com.baidu.mapapi.MKDrivingRouteResult;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 PoiSearchActivity extends MapActivity {// 定义地图引擎管理类private BMapManager mapManager;// 定义搜索服务类private MKSearch mMKSearch;private MapView mapView;private MapController mapController;@Overridepublic void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.main);// 初始化MapActivitymapManager = new BMapManager(getApplication());// init方法的第一个参数需填入申请的API KeymapManager.init("285B415EBAB2A92293E85502150ADA7F03C777C4", null);super.initMapActivity(mapManager);mapView = (MapView) findViewById(R.id.map_View);// 设置地图模式为交通地图mapView.setTraffic(true);// 设置启用内置的缩放控件mapView.setBuiltInZoomControls(true);// 构造一个经纬度点（贵州大学校门口）GeoPoint geoPoint = new GeoPoint((int) (26.449446 * 1E6), (int) (106.682949 * 1E6));// 取得地图控制器对象，用于控制MapViewmapController = mapView.getController();// 设置地图的中心mapController.setCenter(geoPoint);// 设置地图默认的缩放级别mapController.setZoom(16);// 初始化MKSearchmMKSearch = new MKSearch();mMKSearch.init(mapManager, new MySearchListener());// 搜索贵州大学校门口附近500米范围的自动取款机mMKSearch.poiSearchNearBy("ATM", geoPoint, 500);}@Overrideprotected boolean isRouteDisplayed() {return false;}@Overrideprotected void onDestroy() {if (mapManager != null) {// 程序退出前需调用此方法mapManager.destroy();mapManager = null;}super.onDestroy();}@Overrideprotected void onPause() {if (mapManager != null) {// 终止百度地图APImapManager.stop();}super.onPause();}@Overrideprotected void onResume() {if (mapManager != null) {// 开启百度地图APImapManager.start();}super.onResume();}/** * 实现MKSearchListener接口,用于实现异步搜索服务 *  * @author liufeng */public class MySearchListener implements MKSearchListener {/** * 根据经纬度搜索地址信息结果 *  * @param result 搜索结果 * @param iError 错误号（0表示正确返回） */@Overridepublic void onGetAddrResult(MKAddrInfo result, int iError) {}/** * 驾车路线搜索结果 *  * @param result 搜索结果 * @param iError 错误号（0表示正确返回） */@Overridepublic void onGetDrivingRouteResult(MKDrivingRouteResult result, int iError) {}/** * POI搜索结果（范围检索、城市POI检索、周边检索） *  * @param result 搜索结果 * @param type 返回结果类型（11,12,21:poi列表 7:城市列表） * @param iError 错误号（0表示正确返回） */@Overridepublic void onGetPoiResult(MKPoiResult result, int type, int iError) {if (result == null) {return;}// PoiOverlay是baidu map api提供的用于显示POI的OverlayPoiOverlay poioverlay = new PoiOverlay(PoiSearchActivity.this, mapView);// 设置搜索到的POI数据poioverlay.setData(result.getAllPoi());// 在地图上显示PoiOverlay（将搜索到的兴趣点标注在地图上）mapView.getOverlays().add(poioverlay);}/** * 公交换乘路线搜索结果 *  * @param result 搜索结果 * @param iError 错误号（0表示正确返回） */@Overridepublic void onGetTransitRouteResult(MKTransitRouteResult result, int iError) {}/** * 步行路线搜索结果 *  * @param result 搜索结果 * @param iError 错误号（0表示正确返回） */@Overridepublic 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=".PoiSearchActivity" 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）运行结果
     
我们要搜索的是贵州大学校门口500米范围内的ATM，可以在地图上看到，搜索到了5个兴趣点（即A,B,C,D,E标注的位置），点击任何一个兴趣点，会显示该兴趣点的名称。

备注：在本例中，搜索到POI之后，我们直接采用了baibu map api所提示的PoiOverlay将兴趣点标注在地图上。可能大家会有这样的需要：除了将搜索到的POI标注在地图上之外，我还想得到这些POI的信息，如“名称”、“地址”、“经纬度”等，这个问题其实在上一篇已经解答过，这里再次提一下。
      请看PoiSearchActivity类的第135-136行，代码如下：
            // 设置搜索到的POI数据
            poioverlay.setData(result.getAllPoi());
      我们调用了搜索结果类的getAllPoi()方法，它返回的是ArrayList<MKPoiInfo>，即POI信息集合，MKPoiInfo类是一个普通的Java类，我们来看下它里面所包含的属性：
     

/** * MKPoiInfo是兴趣点信息类 */public class MKPoiInfo {// POI名称public String name;// POI地址public String address;// POI所在城市public String city;// POI联系电话public String phoneNum;// POI邮政编码public String postCode;// POI类型public int ePoiType;// POI地理坐标（经纬度）public GeoPoint pt;}

这样，只要遍历ArrayList<MKPoiInfo>就能得到所有POI的相关信息了。完！