更新时间：2020-06-23

地点检索输入提示检索（Sug检索）简介

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

Sug检索与POI检索的区别

使用场景的不同

1. Sug检索是根据部分关键字检索出可能的完整关键字名称，即关键字匹配。
2. POI检索是根据关键字检索符合的POI具体信息。

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

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

建议Sug检索与POI检索配合使用，如：在用户输入关键字时触发Sug检索获取热词，以符合期望的热词为关键字发起POI检索。

可以参考POISearchDemo。

Sug检索示例

1创建Sug检索实例

mSuggestionSearch = SuggestionSearch.newInstance();

2创建Sug检索监听器

OnGetSuggestionResultListener listener = new OnGetSuggestionResultListener() {
    @Override
    public void onGetSuggestionResult(SuggestionResult suggestionResult) {
        //处理sug检索结果
    }
};

3设置Sug检索监听器

mSuggestionSearch.setOnGetSuggestionResultListener(listener);

4设置SuggestionSearchOption对象，发起检索

/**
 * 在您的项目中，keyword为随您的输入变化的值
 */
mSuggestionSearch.requestSuggestion(new SuggestionSearchOption()
        .city("北京")
        .keyword("肯"));

5释放检索实例

mSuggestionSearch.destroy();

注意事项

Sug检索，city为必填项。

Sug检索默认不限制在city内，检索结果优先展示city内结果。示例如图：

通过设置SuggestionSearchOption对象cityLimit字段为true限制Sug检索区域在city内。