浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

Android 地图SDK

百度地图SDK是一套应用程序接口, 通过调用地图SDK接口,开发者可以轻松访问百度地图的服务和数据,构建功能丰富、交互性强的地图类应用程序。

地点检索输入提示服务(Sug检索)简介

地点检索输入提示服务(也被称为POI热词建议检索、在线建议检索、Suggestion POI search),简称Sug检索,是指根据关键词查询在线建议词。为了帮助开发者实现检索出来的关键词快速定位到地图上,SDK开放了检索结果的经纬度信息及对应POI点的UID信息。

地点检索输入提示服务(Sug检索)与POI检索的区别说明

Sug检索和POI检索的使用场景不同。

1)Sug检索的本质是根据部分关键字检索出来可能的完整关键词名称,即关键词匹配;

2)POI检索的功能是检索POI,如果需要查询某些关键词对应的POI的具体信息,请使用POI检索来完成。

Sug检索结果的第一条可能存在没有经纬度信息的情况,该条结果为文字联想出来的关键词结果,并不对应任何确切POI点。

例如输入“肯”,第一条结果为“肯德基”,这条结果是一个泛指的名称,不会带有经纬度等信息。

常用的使用方式:用户输入“关键字”时以Sug检索做为检索入口,边输入边检索热词;输入完成后如还没有搜到结果,再用POI检索以“关键字”为keywords再继续搜索。

具体使用可以参看POISearchDemo。

在线建议检索实现方式如下:

1创建在线建议查询实例;
mSuggestionSearch = SuggestionSearch.newInstance();
2创建在线建议查询监听者;
OnGetSuggestionResultListener listener = new OnGetSuggestionResultListener() {  
    public void onGetSuggestionResult(SuggestionResult res) {  

        if (res == null || res.getAllSuggestions() == null) {  
            return;  
            //未找到相关结果  
        }  

    //获取在线建议检索结果  
    }  
};
3设置在线建议查询监听者;
mSuggestionSearch.setOnGetSuggestionResultListener(listener);
4发起在线建议查询;
// 使用建议搜索服务获取建议列表,结果在onSuggestionResult()中更新  

mSuggestionSearch.requestSuggestion((new SuggestionSearchOption())  

    .keyword(“百度”)  
    .city(“北京”));

5释放在线建议查询实例;
mSuggestionSearch.destroy();
注意事项

Sug检索,城市为必填输入项。

sug检索不控制POI必须在城市内:在传入city后,sug检索无结果时,会扩大检索范围,在全国范围进行检索。(如右图)输入避暑山庄,北京没有,会扩大到全国范围检索;如city内有检索结果,会优先显示city内的数据。sug检索可以city输入全国,但是不建议这么使用,会降低检索精度。

在指定城市内做sug检索:自android v4.2 以上版本起,通过设置citylimit,控制指定城市。

SuggestionSearchOption citylimit(java.lang.Boolean citylimit) 设置是否限制城市范围(选填), 默认为false; 取值为"true"时,仅返回city中指定城市检索结果。

提示:
海外区域暂不支持设置cityLimit。

SugRetrieve1.png