[010] 百度地图API之根据经纬度查询地址信息(Android)

本文主要讲解如何通过百度地图API根据某个经纬度值（地理坐标）查询对应的地址信息以及该地址周边的POI（Point of Interest，兴趣点）信息。
百度地图移动版API不仅包含构建地图的基本接口，还集成了众多搜索服务，包括：位置检索、周边检索、范围检索、公交检索、驾乘检索、步行检索、地址信息查询等。
百度地图移动版API提供的搜索服务主要是通过初始化MKSearch类，注册搜索结果的监听对象MKSearchListener来实现异步搜索服务。首先需要自定义一个MySearchListener类，它实现MKSearchListener接口，然后通过实现接口中不同的回调方法，来获得对应的搜索结果。MySearchListener类的定义如下：

/**
 * 实现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) {
	}

	/**
	 * 公交换乘路线搜索结果
	 * @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) {
	}
}

说明：上面的类定义只是在说明MKSearchListener类的5个方法的作用，全都是空实现，并未给出具体的实现。根据你要检索的内容，再去具体实现上面对应的方法，就能获取到搜索结果。例如：1）你想通过一个地理坐标（经纬度值）来搜索地址信息，那么只需要具体实现上面的onGetAddrResult()方法就能得到搜索结果；2）如果你想搜索驾车路线信息，只需要具体实现onGetDrivingRouteResult()方法就能得到搜索结果。

紧接着，需要初始化MKSearch类：

// 初始化MKSearch
mMKSearch = new MKSearch();
mMKSearch.init(mapManager, new MySearchListener());

经过上面两步之后，就可以通过调用MKSearch所提供的一些检索方法来搜索你想要的信息了。
下面给出一个具体的示例：根据某个经纬度值（地理坐标）查询对应的地址信息以及该地址周边的POI（Point of Interest，兴趣点）信息。
1）布局文件res/layout/query_address.xml

<?xml version="1.0" encoding="utf-8"?>
<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="fill_parent"
    android:layout_height="fill_parent">
	<LinearLayout 
	    android:orientation="vertical"
	    android:layout_width="fill_parent"
	    android:layout_height="fill_parent"
	    >
	    <TextView
	    	android:layout_width="fill_parent"
	    	android:layout_height="wrap_content"
	    	android:text="经度："
	    />
	    <EditText android:id="@+id/longitude_input"
	    	android:layout_width="fill_parent"
	    	android:layout_height="wrap_content" 
	    	android:text="106.720397"
	    />
	    
	    <TextView
	    	android:layout_width="fill_parent"
	    	android:layout_height="wrap_content"
	    	android:text="纬度："
	    />
	    <EditText android:id="@+id/latitude_input"
	    	android:layout_width="fill_parent"
	    	android:layout_height="wrap_content" 
	    	android:text="26.597239"
	    />
	
	    <Button android:id="@+id/query_button"
	    	android:layout_width="wrap_content"
	    	android:layout_height="wrap_content"
	    	android:layout_gravity="right"
	    	android:text="地址查询"
		/>
		
		<TextView android:id="@+id/address_text"
	    	android:layout_width="wrap_content"
	    	android:layout_height="wrap_content"
	    />
	    <!-- 
	    	虽然定义了MapView,但是设置了android:visibility="gone"将其隐藏
	    	因为本示例并不需要显示地图，但不定义又不行（baidu map api的要求） 
	    -->
	    <com.baidu.mapapi.MapView android:id="@+id/map_View"
			android:layout_width="fill_parent"
	    	android:layout_height="fill_parent"
	    	android:clickable="true"
	    	android:visibility="gone"
	    />
	</LinearLayout>
</ScrollView>

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

package com.liufeng.baidumap;

import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;

import com.baidu.mapapi.BMapManager;
import com.baidu.mapapi.GeoPoint;
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;

/**
 * 根据经纬度查询地址信息
 * 
 * @author liufeng
 * @date 2011-05-03
 */
public class QueryAddressActivity extends MapActivity {
	// 定义地图引擎管理类
	private BMapManager mapManager;
	// 定义搜索服务类
	private MKSearch mMKSearch;

	private EditText longitudeEditText;
	private EditText latitudeEditText;
	private TextView addressTextView;
	private Button queryButton;

	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.query_address);

		// 初始化MapActivity
		mapManager = new BMapManager(getApplication());
		// init方法的第一个参数需填入申请的API Key
		mapManager.init("285B415EBAB2A92293E85502150ADA7F03C777C4", null);
		super.initMapActivity(mapManager);

		// 初始化MKSearch
		mMKSearch = new MKSearch();
		mMKSearch.init(mapManager, new MySearchListener());

		// 通过id查询在布局文件中定义的控件
		longitudeEditText = (EditText) findViewById(R.id.longitude_input);
		latitudeEditText = (EditText) findViewById(R.id.latitude_input);
		addressTextView = (TextView) findViewById(R.id.address_text);
		queryButton = (Button) findViewById(R.id.query_button);

		// 给地址查询按钮设置单击事件监听器
		queryButton.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				// 用户输入的经度值
				String longitudeStr = longitudeEditText.getText().toString();
				// 用户输入的纬度值
				String latitudeStr = latitudeEditText.getText().toString();

				try {
					// 将用户输入的经纬度值转换成int类型
					int longitude = (int) (1000000 * Double.parseDouble(longitudeStr));
					int latitude = (int) (1000000 * Double.parseDouble(latitudeStr));

					// 查询该经纬度值所对应的地址位置信息
					mMKSearch.reverseGeocode(new GeoPoint(latitude, longitude));
				} catch (Exception e) {
					addressTextView.setText("查询出错，请检查您输入的经纬度值！");
				}
			}
		});
	}

	@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) {
			if (result == null) {
				return;
			}
			StringBuffer sb = new StringBuffer();
			// 经纬度所对应的位置
			sb.append(result.strAddr).append("/n");

			// 判断该地址附近是否有POI（Point of Interest,即兴趣点）
			if (null != result.poiList) {
				// 遍历所有的兴趣点信息
				for (MKPoiInfo poiInfo : result.poiList) {
					sb.append("----------------------------------------").append("/n");
					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");
					sb.append("电话：").append(poiInfo.phoneNum).append("/n");
					sb.append("邮编：").append(poiInfo.postCode).append("/n");
					// poi类型，0：普通点，1：公交站，2：公交线路，3：地铁站，4：地铁线路
					sb.append("类型：").append(poiInfo.ePoiType).append("/n");
				}
			}
			// 将地址信息、兴趣点信息显示在TextView上
			addressTextView.setText(sb.toString());
		}

		/**
		 * 驾车路线搜索结果
		 * 
		 * @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) {
		}

		/**
		 * 公交换乘路线搜索结果
		 * 
		 * @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=".QueryAddressActivity" 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）运行结果截图及说明

程序在模拟器上运行的初始效果如上图所示。可以看出，地图并没有显示出来，这和我们在设计时布局时所设想的一样；另外两个输入框中也分别显示了默认给出的经纬度值。
点击“地址查询”按钮后，将看到如下图所示包含了查询结果的界面：

说明：图上的“贵州省贵阳市云岩区普陀路”正是我们要查询的地理坐标（经度：106.720397，纬度：26.597239）所对应的地址信息；同时该地址信息下方还显示出了该地址附近的10个兴趣点（POI），每个兴趣点分别包含了“名称”、“地址”、“经纬度”、“电话”、“邮编”和“兴趣点类型”信息。

备注：如果本文的示例继续做下去，就应该将MapView显示出来，同时结合第8篇文章“[008] 百度地图API之ItemizedOverlay的使用(Android)”所介绍的内容将地址信息和兴趣点标注在地图上。我想这两方面的内容都已做过详细讲解并给出了示例，再来实现这个应该并不是什么难事，看文章的你就动动手来完成它吧！