高德地图-搜索服务-POI搜索
高德地图-搜索服务-POI搜索
之前公司项目收货地址仿饿了么的收货地址，结果发现自己实现的关键字搜索和周边搜索，搜索到的poi列表跟饿了么的并不完全一样，后来考虑了下，应该是搜索的范围、类型之类的设置的不一样。后来搜索了下，也的确是这样，，现在记录下来，留给自己也留给大家。
高德地图 Android SDK 提供了千万级别的POI（Point Of Interesting，兴趣点）的搜索。
目前支持关键字搜索、周边搜索、指定区域搜索的同步、异步方法。搜索返回 POI 的基本信息，如POI ID，POI 名称、类型、经纬度、地址等。
关键字搜索
通过 PoiSearch.Query(String query, String ctgr, String city) 设置搜索条件。参数“query”为搜索的关键字，“ctgr”为搜索类型（类型参照表从相关下载处获取）、“city”为搜索城市，是必填参数，关键字和类型至少输入一个。
设置搜索条件，发送请求
query = new PoiSearch.Query(keyWord, "", cityCode); // keyWord表示搜索字符串， //第二个参数表示POI搜索类型，二者选填其一， //POI搜索类型共分为以下20种：汽车服务|汽车销售| //汽车维修|摩托车服务|餐饮服务|购物服务|生活服务|体育休闲服务|医疗保健服务| //住宿服务|风景名胜|商务住宅|政府机构及社会团体|科教文化服务|交通设施服务| //金融保险服务|公司企业|道路附属设施|地名地址信息|公共设施 //cityCode表示POI搜索区域的编码，是必须设置参数 query.setPageSize(10);// 设置每页最多返回多少条poiitem query.setPageNum(currentPage);//设置查询页码 PoiSearch poiSearch = new PoiSearch(this, query);//初始化poiSearch对象 poiSearch.setOnPoiSearchListener(this);//设置回调数据的监听器 poiSearch.searchPOIAsyn();//开始搜索
通过回调接口接受并解析返回的结果。
public void onPoiSearched(PoiResult result, int rCode) { //可以在回调中解析result，获取POI信息 //result.getPois()可以获取到PoiItem列表，Poi详细信息可参考PoiItem类 //若当前城市查询不到所需Poi信息，可以通过result.getSearchSuggestionCitys()获取当前Poi搜索的建议城市 //如果搜索关键字明显为误输入，则可通过result.getSearchSuggestionKeywords()方法得到搜索关键词建议 //返回结果成功或者失败的响应码。0为成功，其他为失败（详细信息参见网站开发指南-错误码对照表） }
显示效果如图所示：
周边搜索
使用 PoiSearch.searchPOIAsyn() 搜索 POI。使用 PoiSearch.setOnPoiSearchListener() 方法设置监听器，在 PoiSearch.OnPoiSearchListener 接口回调方法 onPoiSearched(PoiResult poiResult,int rCode)中处理返回结果。当指定搜索城市时，若没有返回 POI 结果，则会返回包含关键字的建议城市名称。当关键字搜索无结果时，则会返回搜索建议关键字。
设置搜索条件，发送请求
query = new PoiSearch.Query(keyWord, "汽车维修|餐饮服务", cityCode); // keyWord表示搜索字符串，第二个参数表示POI搜索类型，默认为：生活服务、餐饮服务、商务住宅 //共分为以下20种：汽车服务|汽车销售| //汽车维修|摩托车服务|餐饮服务|购物服务|生活服务|体育休闲服务|医疗保健服务| //住宿服务|风景名胜|商务住宅|政府机构及社会团体|科教文化服务|交通设施服务| //金融保险服务|公司企业|道路附属设施|地名地址信息|公共设施 //cityCode表示POI搜索区域，（这里可以传空字符串，空字符串代表全国在全国范围内进行搜索） query.setPageSize(10);// 设置每页最多返回多少条poiitem query.setPageNum(currentPage);//设置查第一页 PoiSearch poiSearch = new PoiSearch(this,query); poiSearch.setBound(new SearchBound(new LatLonPoint(locationMarker.getPosition().latitude, locationMarker.getPosition().longitude), 1000));//设置周边搜索的中心点以及区域 poiSearch.setOnPoiSearchListener(this);//设置数据返回的监听器 poiSearch.searchPoiAsyn();//开始搜索
通过回调接口获取数据
public void onPoiSearched(PoiResult result, int rCode) { //在回调函数中解析result获取POI信息 //result.getPois()可以获取到PoiItem列表，Poi详细信息可参考PoiItem类 //若当前城市查询不到所需Poi信息，可以通过result.getSearchSuggestionCitys()获取当前Poi搜索的建议城市 //如果搜索关键字明显为误输入，则可通过result.getSearchSuggestionKeywords()方法得到搜索关键词建议 //返回结果成功或者失败的响应码。0为成功，其他为失败（详细信息参见网站开发指南-错误码对照表） }
显示效果如图所示：
区域搜索
在周边搜索的基础上，增加了矩形限定区域。根据搜索矩形区域左下角和右上角的顶点坐标，使用 PoiSearch.SearchBound(LatLonPoint lowerLeft, LatLonPoint upperRight) 设置搜索范围。
输入提示搜索
在输入关键字（至少两个字符）时，可以使用Inputtips类的 Inputtips.InputtipsListener 接口监听输入信息，并使用 requestInputtips(String keyword, String city) 发送提示请求。
注：提示中会出现相同的关键字，但是这些关键字所在区域不同，使用时可以通过 tipList.get(i).getDistrict() 获得区域，也可以在提示时在关键字后加上区域。
例如用户输入“高德”，输入框下方的列表会显示包含关键字字段的输入提示信息。
显示效果如图所示：
示例代码如下：
// 发送输入提示请求 // newText表示提示关键字，第二个参数默认代表全国，也可以为城市区号 inputTips.requestInputtips(newText, "");
通过回调接口获取数据
public void onGetInputtips(List<Tip> inputTips, int rcode){ //在回调函数中解析inputTips,获取输入提示返回的信息 //Tip类中包含Poi的Adcode、District、Name信息 //返回结果成功或者失败的响应码。0为成功，其他为失败（详细信息参见网站开发指南-错误码对照表） }
行政区划搜索
根据县（区）级行政区划名称查询其下级区划的详细信息，如：中心点坐标、编码等等。
DistrictSearch search = new DistrictSearch(mContext); DistrictSearchQuery query = new DistrictSearchQuery(); query.setKeywords("keywords");//传入关键字 query.setKeywordsLevel(DistrictSearchQuery.KEYWORDS_CITY); query.setShowBoundary(true);//是否返回边界值 search.setQuery(query); search.setOnDistrictSearchListener(this);//绑定监听器 search.searchDistrictAnsy();//开始搜索
通过回调接口获取数据
public void onDistrictSearched(DistrictResult districtResult) { //在回调函数中解析districtResult获取行政区划信息 //在districtResult.getAMapException().getErrorCode()=0时调用districtResult.getDistrict()方法 //获取查询行政区的结果，详细信息可以参考DistrictItem类。 }
显示效果如图所示：