使用产品

Android 地图 SDK（检索功能已经整合到地图SDK中）

核心类说明

1、TencentSearch：检索功能的主入口，用于发起检索。
2、SearchParam：城市地点检索。

示例核心点讲解

/**
    * poi检索
    */
protected void searchPoi() {
    TencentSearch tencentSearch = new TencentSearch(this);
    String keyWord = etSearch.getText().toString().trim();
    //城市搜索
    SearchParam.Region region = new SearchParam
            //设置搜索城市
            .Region("北京")
            //设置搜索范围不扩大
            .autoExtend(false);

    //构建地点检索
    SearchParam searchParam = new SearchParam(keyWord, region);
    tencentSearch.search(searchParam, new HttpResponseListener<BaseObject>() {

        @Override
        public void onFailure(int arg0, String arg2,
                                Throwable arg3) {
            Toast.makeText(getApplicationContext(), arg2, Toast.LENGTH_LONG).show();
        }

        @Override
        public void onSuccess(int arg0, BaseObject arg1) {
            if (arg1 == null) {
                return;
            }
            SearchResultObject obj = (SearchResultObject) arg1;
            if(obj.data == null){
                return;
            }
            //将地图中心坐标移动到检索到的第一个地点
            tencentMap.moveCamera(CameraUpdateFactory
                    .newCameraPosition(
                            new CameraPosition(obj.data.get(0).latLng,
                            //设置缩放级别到 15 级
                                    15f, 
                                    0, 
                                    0)));
            //将其他检索到的地点在地图上用 marker 标出来
            for(SearchResultObject.SearchResultData data : obj.data){
                Log.v("SearchDemo","title:"+data.title + ";" + data.address);
                tencentMap.addMarker(new MarkerOptions()
                        //标注的位置
                        .position(data.latLng)
                        //标注的InfoWindow的标题
                        .title(data.title)
                        //标注的InfoWindow的内容
                        .snippet(data.address)
                );

            }
        }
    });
}

注意点

地点搜索 tencentSearch.search(SearchParam object, HttpResponseListener listener) 接口，封装了腾讯地图 WebService API 的地点搜索功能，更详细的接口描述可以查阅官网。这里对 SDK 提供的地点搜索接口做简要描述。

使用产品

iOS 地图 SDK（检索功能已经整合到地图SDK中，具体使用方法可以参考检索功能官方文档。）

核心类说明

1. QMSSearcher：检索功能的主入口，用于发起检索。
2. QMSPoiSearchOption：POI检索参数配置类。
3. QMSPoiSearchResult：POI检索结果类，包含检索返回的数据、结果状态、搜索结果数等数据。
4. QMSPoiData：POI检索结果数据类，通常包含于 QMSPoiSearchResult 中，包含了POI的数据。

示例核心点讲解

1. 创建检索对象：

1. 使用检索功能之前，需要注册 API Key（与地图功能类似，但不是同一个接口），通常在 AppDelegate 类中注册：

   #import <QMapKit/QMSSearchKit.h>
   
   - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
   
   	[QMSSearchServices sharedServices].apiKey = @"您的Key";
   }
   

2. 创建检索对象，并设置代理对象。注意检索对象需要声明为成员变量，如果声明为局部变量的话，将会导致无法接收检索回调：

   @interface PickMapPointViewController () <QMSSearchDelegate>
   @property (nonatomic, strong) QMSSearcher *mapSearcher;
   @end
   
   // 创建 QMSSearcher 对象
   - (QMSSearcher *)mapSearcher {
       if (_mapSearcher == nil) {
           _mapSearcher = [[QMSSearcher alloc] initWithDelegate:self];
       }
       
       return _mapSearcher;
   }
   

2. 配置检索参数对象

1. 创建 POI 检索参数对象。注意检索参数对象的 keyword 属性为必填项：

   QMSPoiSearchOption *option = [[QMSPoiSearchOption alloc] init];
   option.keyword = @"酒店";
   

2. 检索范围可以设定为指定地区（region）、周边（nearby）和矩形范围（rectangle），在示例中演示了如何使用周边检索：

   // SDK提供了字符串配置检索区域和快速构建方法两种方式
   // 字符串配置检索区域
   option.boundary = [NSString stringWithFormat:@"nearby(%f,%f,2000,1)", centerCoord.latitude, centerCoord.longitude];
   
   // 快速构建方法
   [option setBoundaryByNearbyWithCenterCoordinate:CLLocationCoordinate2DMake(centerCoord.latitude, centerCoord.longitude)
                                            radius:2000
                                        autoExtend:YES];
   

3. 通过检索参数，使用检索对象发起搜索：

   [self.mapSearcher searchWithPoiSearchOption:option];
   

3. 解析检索结果

• 在当前控制器中实现 <QMSSearchDelegate> 的代理方法，获取检索结果：

  - (void)searchWithPoiSearchOption:(QMSPoiSearchOption *)poiSearchOption didReceiveResult:(QMSPoiSearchResult *)poiSearchResult {
  	// 判断检索结果是否为空
  	if (poiSearchResult.count == 0) {
  		return;
  	}
  	
  	// 获取检索结果
  	_searchResultArray = poiSearchResult.dataArray;
  	
  	// 以下为操作检索结果代码，可以在Demo中查看
  	......
  }
  

注意点

1. 使用检索SDK之前，需要开启Key的 WebService API 功能：

   

2. 检索SDK是对 WebService API 能力的封装，因此有配额限制，为了避免频繁的发送请求，Demo演示了在每次地图移动结束之后的回调方法中发起检索：

   // 地图视野区域发生改变后调用
   - (void)mapView:(QMapView *)mapView regionDidChangeAnimated:(BOOL)animated gesture:(BOOL)bGesture {
   
   	// 请求当前地点周边的酒店
   	[self searchCurrentLocationWithKeyword:@"酒店"];
   }
   

3. WebService API中包含三种鉴权方式：域白名单、授权IP和签名校验。此三种鉴权主要用于浏览器、后台调用等方式。在SDK端不建议开启鉴权，如需使用签名校验等鉴权，则检索SDK的接口将无法使用，并且需要用户通过HTTP请求的方式去调用WebService API接口。