地点搜索

最后更新时间:2025-03-13

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

请求参数概览

返回结果

tencentSearch.search(SearchParam object, HttpResponseListener listener) 获取的检索结果由参数 listener 异步返回。当 HttpResponseListener.onSuccess 正常返回时，应将 BaseObject 强转为 SearchResultObject 进行解析，包含的数据请参考 接口文档, 当 HttpResponseListener.onFailure 返回时，请用户根据的状态码和错误信息检查自己的参数输入：

调用示例

/**
 * 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是通过MapView对象调用getMap()方法获得
            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)
                );

            }
        }
    });
}

注意点

1. 如果当前城市为省直辖县级区划，city字段会返回为空，由district字段返回。省直辖县级区划adcode第3和第4位分别为9、0。
2. pageSize目前最大支持20，超出20不再召回数据，设置50会出现异常，错误码113,原因内部接口未开放。