其他文章:
安卓百度离线地图的下载以及使用
安卓百度地图（一）定位功能的实现、周边POI的检索
安卓百度地图（二）地图显示以及离线地图的下载使用
安卓百度地图（三）绘制点、线等图层信息
安卓百度地图（五）百度地图路线规划
安卓百度地图（六）鹰眼轨迹的上传，历史轨迹的显示
安卓百度地图（七）地理围栏的建立与使用
本文就百度地图的城市，周边，区域POI检索，进行整理
一 POI检索简介
POI（Point of Interest），中文可以翻译为“兴趣点”。在地理信息系统中，一个POI可以是一栋房子、一个商铺、一个邮筒、一个公交站等。
百度地图SDK提供三种类型的POI检索：城市内检索、周边检索和区域检索（即矩形范围检索）。下面将以POI城市内检索、周边检索 和 区域检索为例，向大家介绍如何使用检索服务。
二 POI检索
2.1 创建POI检索实例
mPoiSearch = PoiSearch.newInstance();
2.2 设置POI检索监听者
mPoiSearch.setOnGetPoiSearchResultListener(poiListener);
2.3 创建POI检索监听
OnGetPoiSearchResultListener poiListener = new OnGetPoiSearchResultListener() {
public void onGetPoiResult(PoiResult result) {
if (result == null || result.error != SearchResult.ERRORNO.NO_ERROR) {
Toast.makeText(PoiActivity.this, "未搜索到POI数据", Toast.LENGTH_SHORT).show();
}
if (result.error == SearchResult.ERRORNO.NO_ERROR) {
//获取POI检索结果
Toast.makeText(PoiActivity.this, "已搜索到POI数据", Toast.LENGTH_SHORT).show();
}
if (result.error == SearchResult.ERRORNO.AMBIGUOUS_KEYWORD) {
// 当输入关键字在本市没有找到，但在其他城市找到时，返回包含该关键字信息的城市列表
String strInfo = "在";
for (CityInfo cityInfo : result.getSuggestCityList()) {
strInfo += cityInfo.city;
strInfo += ",";
}
strInfo += "找到结果";
Toast.makeText(PoiActivity.this, strInfo, Toast.LENGTH_LONG).show();
}
}
2.4发起检索请求
2.4.1 城市内检索
输入城市名(city)，以及物品(name),和页码(num)发起检索。
mPoiSearch.searchInCity((new PoiCitySearchOption())
.city(city)
.keyword(name)
.pageNum(num));
2.4.2 周边检索
周边搜索是一个圆形范围，适用于以某个位置为中心点，输入圆心(center)、自定义检索半径值(radius)和页码(num)发起检索。
mPoiSearch.searchNearby(new PoiNearbySearchOption()
.keyword("餐厅")
.sortType(PoiSortType.distance_from_near_to_far)
.location(center)
.radius(radius)
.pageNum(num));
2.4.2 区域检索（即矩形范围检索）
POI区域检索以“用户指定的左下角和右上角坐标的长方形区域”为检索范围的poi检索。
LatLng southwest = new LatLng( 39.92235, 116.380338 );
LatLng northeast = new LatLng( 39.947246, 116.414977);
LatLngBounds searchbound = new LatLngBounds.Builder()
.include(southwest)
.include(northeast)
.build();
mPoiSearch.searchInBound(new PoiBoundSearchOption()
.bound(searchbound)
.keyword("餐厅"));
2.5 热词建议检索
2.5.1 创建在线建议查询实例
mSuggestionSearch = SuggestionSearch.newInstance();
2.5.2 创建在线建议查询监听者
OnGetSuggestionResultListener listener = new OnGetSuggestionResultListener() {
public void onGetSuggestionResult(SuggestionResult res) {
if (res == null || res.getAllSuggestions() == null) {
return;
//未找到相关结果
}
//获取在线建议检索结果
}
};
2.5.3 设置在线建议查询监听者
mSuggestionSearch.setOnGetSuggestionResultListener(listener);
2.5.4 发起在线建议查询
// 使用建议搜索服务获取建议列表，结果在onSuggestionResult()中更新
mSuggestionSearch.requestSuggestion((new SuggestionSearchOption())
.keyword(“百度”)
.city(“北京”));
2.5.5 释放在线建议查询实例；
mSuggestionSearch.destroy();
2.6 释放POI检索实例；
mPoiSearch.destroy();
2.7 注意事项
- 在传入city检索无结果时，会扩大检索范围，在全国进行检索。如有检索结果，不会直接返回，但会提示哪些城市有结果。
- 在传入city检索时，返回的结果太多，涉及多个城市，可以将扩大检索的城市list罗列，让用户点击选择，再针对选定城市进行二次检索（如果只有一个城市，后端直接进行二次检索）。可以调用的接口在PoiResult类中：
public List<CityInfo> getSuggestCityList() //返回城市列表页的结果数
三 公交线路查询
3.1 线路名称查询
输入公交线路的名称，POI检索返回的POI结果中，epoitype字段表示POI类型，epoitype字段值为2表示公交路线，4表示地铁路线，把这两种类型的POI的uid传给公交信息检索接口，可以得到该POI所代表的路线的详细信息（如：该公交线有多少个站点，每个站点的名称，位置、参考票价和上下线行信息）。
3.1.1 发起POI检索，获取相应线路的UID；
//以城市内检索为例，详细方法请参考POI检索部分的相关介绍
mSearch.searchInCity((new PoiCitySearchOption())
.city(“北京”)
.keyword(“302”);
3.1.2 在POI检索结果中判断该POI类型是否为公交信息
public void onGetPoiResult(PoiResult result) {
if (result == null || result.error != SearchResult.ERRORNO.NO_ERROR) {
return;
}
//遍历所有POI，找到类型为公交线路的POI
for (PoiInfo poi : result.getAllPoi()) {
if (poi.type == PoiInfo.POITYPE.BUS_LINE ||poi.type == PoiInfo.POITYPE.SUBWAY_LINE) {
//说明该条POI为公交信息，获取该条POI的UID
busLineId = poi.uid;
break;
}
}
}
3.1.3定义并设置公交信息结果监听者（与POI类似），并发起公交详情检索
//如下代码为发起检索代码，定义监听者和设置监听器的方法与POI中的类似
mBusLineSearch.searchBusLine((new BusLineSearchOption()
.city(“北京”)
.uid(busLineId)));
//线路 ID 查询
获取公交线路的详细信息，可使用线路 ID 查询。结果返回线路信息有线路 ID、公交类型、线路名称、线路坐标、城市编码、首发站、末站、首班车时间、末班车时间、全程里程、起步价、全程票价、线路沿途坐标。
<pre>
四 地理编码
地理编码分：正向地图编码、反向地图编码
正向地理编码：将地址信息转换为坐标点
反向地理编码：将坐标点转换为地址信息
GeoCoder mSearch = GeoCoder.newInstance();//初始化地理编码
mSearch.setOnGetGeoCodeResultListener(listener);//设置回调监听
ReverseGeoCodeOption reverseGeoCodeOption = new ReverseGeoCodeOption();
reverseGeoCodeOption.location(new LatLng(36.897,127.9897));//设置坐标点
mSearch.reverseGeoCode(reverseGeoCodeOption);//将坐标点转换为地址信息
GeoCodeOption geoCodeOption = new GeoCodeOption();
geoCodeOption.address(addressStr);//设置地址
geoCodeOption.city(cityStr);//设置城市
mSearch.geocode(geoCodeOption);//将地址信息转换为坐标点
OnGetGeoCoderResultListener listener = new OnGetGeoCoderResultListener() {
@Override
public void onGetGeoCodeResult(GeoCodeResult geoCodeResult) {
//正向地理编码回调，注意geoCodeResult中错误码的处理
geoCodeResult.getLocation();//坐标点
geoCodeResult.getAddress();//地址信息
}
@Override
public void onGetReverseGeoCodeResult(ReverseGeoCodeResult reverseGeoCodeResult) {
//反向地理编码回调
reverseGeoCodeResult.getAddress();//简要地址信息
reverseGeoCodeResult.getAddressDetail();//层次化地址信息
reverseGeoCodeResult.getBusinessCircle();//所属商圈名称
reverseGeoCodeResult.getPoiList();//周边POI信息集合
reverseGeoCodeResult.getSematicDescription();//描述信息
reverseGeoCodeResult.getLocation();//坐标点
}
});
五 行政区边界数据检索
根据省、市、县（区）级行政区划名称，查询行政区划的详细边界信息。
DistrictSearch mDistrictSearch = DistrictSearch.newInstance();//初始化行政区检索
mDistrictSearch.setOnDistrictSearchListener(listener );//设置回调监听
DistrictSearchOption districtSearchOption = new DistrictSearchOption();
districtSearchOption.cityName(cityStr);//检索城市名称
districtSearchOption.districtName(districtStr);//检索的区县名称
mDistrictSearch.searchDistrict(districtSearchOption);//请求行政区数据
OnGetDistricSearchResultListener listener = new OnGetDistricSearchResultListener() {
@Override
public void onGetDistrictResult(DistrictResult districtResult) {
districtResult.getCenterPt();//获取行政区中心坐标点
districtResult.getCityName();//获取行政区域名称
List<List<LatLng>> polyLines = districtResult.getPolylines();//获取行政区域边界坐标点
//边界就是坐标点的集合，在地图上画出来就是多边形图层。有的行政区可能有多个区域，所以会有多个点集合。
}
};
本文主要做于收集整理笔记使用，关于文章的源码，请移步我的GitHub
