高德提供了千万级别的POI（Point of Interest，兴趣点）。在地图表达中，一个POI可代表一栋大厦、一家商铺、一处景点等等。通过POI搜索，完成找餐馆、找景点、找厕所等等的功能。

根据关键字检索适用于在某个城市搜索某个名称相关的POI，例如：查找北京市的“肯德基”。

第 1 步，引入头文件

引入 AMapFoundationKit.h 和 AMapSearchKit.h 这两个头文件。

第 2 步，配置Key

在使用搜索功能时，需要添加 Key。

如果您使用的是搜索库（AMapSearchKit.framework） v4.x 版本需要引入基础 SDK ，设置 Key 的方法如下：

iOS 搜索功能 v4.x 版本设置 Key：

如果您使用的是搜索功能 v3.x 或之前版本，请您尽快更新。

iOS 搜索功能 v3.x 版本设置 Key：

第 3 步，定义 AMapSearchAPI

定义主搜索对象 AMapSearchAPI ，并继承搜索协议<AMapSearchDelegate>。

第 4 步，构造 AMapSearchAPI

构造主搜索对象 AMapSearchAPI，并设置代理。

第 5 步，设置关键字检索参数

进行关键字检索的请求参数类为 AMapPOIKeywordsSearchRequest，其中 keywords 是必设参数。types 为搜索类型。

第 6 步，发起POI关键字搜索

调用 AMapSearchAPI 的 AMapPOIKeywordsSearch 并发起关键字检索。

第 7 步，在回调中处理数据

当检索成功时，会进到 onPOISearchDone 回调函数中，通过解析 AMapPOISearchResponse 对象把检索结果在地图上绘制点展示出来。

说明：

1）可以在回调中解析 response，获取 POI 信息。

2）response.pois 可以获取到 AMapPOI 列表，POI 详细信息可参考 AMapPOI 类。

3）若当前城市查询不到所需 POI 信息，可以通过 response.suggestion.cities 获取当前 POI 搜索的建议城市。

4）如果搜索关键字明显为误输入，则可通过 response.suggestion.keywords 属性得到搜索关键词建议。

适用于搜索某个位置附近的POI，可设置POI的类别，具体查询所在位置的餐饮类、住宅类POI，例如：查找天安门附近的厕所等等场景。

说明：

1、支持指定查询POI的类别。高德地图的POI类别共20个大类，分别为：汽车服务、汽车销售、汽车维修、摩托车服务、餐饮服务、购物服务、生活服务、体育休闲服务、医疗保健服务、住宿服务、风景名胜、商务住宅、政府机构及社会团体、科教文化服务、交通设施服务、金融保险服务、公司企业、道路附属设施、地名地址信息、公共设施，同时，每个大类别都还有二级以及三级的细小划分，具体的POI类别请参考：

2、不设置POI的类别，默认返回“餐饮服务”、“商务住宅”、“生活服务”这三种类别的POI。

第 1 步，引入头文件

引入 AMapFoundationKit.h 和 AMapSearchKit.h 这两个头文件。

第 2 步，配置Key

在使用搜索功能时，需要添加 Key。

如果您使用的是搜索库（AMapSearchKit.framework） v4.x 版本需要引入基础 SDK ，设置 Key 的方法如下：

iOS 搜索功能 v4.x 版本设置 Key：

如果您使用的是搜索功能 v3.x 或之前版本，请您尽快更新。

iOS 搜索功能 v3.x 版本设置 Key：

第 3 步，定义 AMapSearchAPI

定义主搜索对象 AMapSearchAPI ，并继承搜索协议<AMapSearchDelegate>。

第 4 步，构造 AMapSearchAPI

构造主搜索对象 AMapSearchAPI，并设置代理。

第 5 步，设置周边检索的参数

请求参数类为 AMapPOIAroundSearchRequest，location是必设参数。

第 6 步，发起周边检索

调用 AMapSearchAPI 的 AMapPOIAroundSearch 并发起周边检索。

第 7 步，在回调中处理数据

当检索成功时，会进到 onPOISearchDone 回调函数中，通过解析 AMapPOISearchResponse 对象把检索结果在地图上绘制点展示出来。

说明：

1）可以在回调中解析 response，获取 POI 信息。

2）response.pois 可以获取到 AMapPOI 列表，POI 详细信息可参考 AMapPOI 类。

3）若当前城市查询不到所需 POI 信息，可以通过 response.suggestion.cities 获取当前 POI 搜索的建议城市。

4）如果搜索关键字明显为误输入，则可通过 response.suggestion.keywords法得到搜索关键词建议。

不同于周边搜索，周边搜索是一个圆形范围，而多边形搜索的范围是一个多边形，适用于在搜索某个不规则区域的POI，例如：查找中关村范围内的停车场。

第 1 步，引入头文件

引入 AMapFoundationKit.h 和 AMapSearchKit.h 这两个头文件。

第 2 步，配置Key

在使用搜索功能时，需要添加 Key。

如果您使用的是搜索库（AMapSearchKit.framework） v4.x 版本需要引入基础 SDK ，设置 Key 的方法如下：

iOS 搜索功能 v4.x 版本设置 Key：

如果您使用的是搜索功能 v3.x 或之前版本，请您尽快更新。

iOS 搜索功能 v3.x 版本设置 Key：

第 3 步，定义 AMapSearchAPI

定义主搜索对象 AMapSearchAPI ，并继承搜索协议<AMapSearchDelegate>。

第 4 步，构造 AMapSearchAPI

构造主搜索对象 AMapSearchAPI，并设置代理。

第 5 步，设置多边形检索的参数

请求参数类为 AMapPOIPolygonSearchRequest，polygon是必填参数。

第 6 步，发起多边形检索

调用 AMapSearchAPI 的 AMapPOIPolygonSearch 并发起多边形检索。

第 7 步，在回调中处理数据

当检索成功时，会进到 onPOISearchDone 回调函数中，通过解析 AMapPOISearchResponse 对象把检索结果在地图上绘制点展示出来。

说明：

1）可以在回调中解析 response，获取 POI 信息。

2）response.pois 可以获取到 AMapPOI 列表，POI 详细信息可参考 AMapPOI 类。

3）若当前城市查询不到所需 POI 信息，可以通过 response.suggestion.cities 获取当前 POI 搜索的建议城市。

4）如果搜索关键字明显为误输入，则可通过 response.suggestion.keywords法得到搜索关键词建议。

通过关键字检索、周边检索以及多边形检索查询到的POI信息，可通过ID检索来获取POI详细的信息。

第 1 步，引入头文件

引入 AMapFoundationKit.h 和 AMapSearchKit.h 这两个头文件。

第 2 步，配置Key

在使用搜索功能时，需要添加 Key。

如果您使用的是搜索库（AMapSearchKit.framework） v4.x 版本需要引入基础 SDK ，设置 Key 的方法如下：

iOS 搜索功能 v4.x 版本设置 Key：

如果您使用的是搜索功能 v3.x 或之前版本，请您尽快更新。

iOS 搜索功能 v3.x 版本设置 Key：

第 3 步，定义 AMapSearchAPI

定义主搜索对象 AMapSearchAPI ，并继承搜索协议<AMapSearchDelegate>。

第 4 步，构造 AMapSearchAPI

构造主搜索对象 AMapSearchAPI，并设置代理。

第 5 步，设置ID检索的参数

第 6 步，发起ID检索

第 7 步，在回调中处理数据

当检索成功时，会进到 onPOISearchDone 回调函数中，通过解析 AMapPOISearchResponse 对象把检索结果在地图上绘制点展示出来。

说明：

1）可以在回调中解析 response，获取 POI 信息。

2）response.pois 可以获取到 AMapPOI 列表，POI 详细信息可参考 AMapPOI 类。

3）若当前城市查询不到所需 POI 信息，可以通过 response.suggestion.cities 获取当前 POI 搜索的建议城市。

4）如果搜索关键字明显为误输入，则可通过 response.suggestion.keywords法得到搜索关键词建议。

从搜索 SDK 4.3.0 版本开始支持，可根据规划的路径，查询该路径沿途的加油站、ATM、汽修店、厕所。

引入 AMapFoundationKit.h 和 AMapSearchKit.h 这两个头文件。

第 2 步，配置Key

在使用搜索功能时，需要添加 Key。

如果您使用的是搜索库（AMapSearchKit.framework） v4.x 版本需要引入基础 SDK ，设置 Key 的方法如下：

iOS 搜索功能 v4.x 版本设置 Key：

如果您使用的是搜索功能 v3.x 或之前版本，请您尽快更新。

iOS 搜索功能 v3.x 版本设置 Key：

定义主搜索对象 AMapSearchAPI ，并继承搜索协议<AMapSearchDelegate>。

构造主搜索对象 AMapSearchAPI，并设置代理。

请求参数类为  AMapRoutePOISearchRequest ，origin和destination是必填参数。

当检索成功时，会进到 onRoutePOISearchDone 回调函数中，通过解析 AMapRoutePOISearchResponse 对象获取POI，并在地图上显示。

说明：

1）可以在回调中解析 response，获取 POI 信息。

2）response.pois 可以获取到 AMapPOI 列表，POI 详细信息可参考 AMapPOI 类。

输入提示是指根据用户输入的关键词，给出相应的提示信息，将最有可能的搜索词呈现给用户，以减少用户输入信息，提升用户体验。如：输入“方恒”，提示“方恒国际中心A座”，“方恒购物中心”等。

输入提示返回的提示语对象 AMapTip 有多种属性，可根据该对象的返回信息，配合其他搜索服务使用，完善您应用的功能。如：

1）uid为空，location为空，该提示语为品牌词，可根据该品牌词进行POI关键词搜索。

2）uid不为空，location为空，为公交线路，根据uid进行公交线路查询。

3）uid不为空，location也不为空，是一个真实存在的POI，可直接显示在地图上。

第 1 步，引入头文件

引入 AMapFoundationKit.h 和 AMapSearchKit.h 这两个头文件。

第 2 步，配置Key

在使用搜索功能时，需要添加 Key。

如果您使用的是搜索库（AMapSearchKit.framework） v4.x 版本需要引入基础 SDK ，设置 Key 的方法如下：

iOS 搜索功能 v4.x 版本设置 Key：

如果您使用的是搜索功能 v3.x 或之前版本，请您尽快更新。

iOS 搜索功能 v3.x 版本设置 Key：

第 3 步，定义 AMapSearchAPI

定义主搜索对象 AMapSearchAPI ，并继承搜索协议<AMapSearchDelegate>。

第 4 步，构造 AMapSearchAPI

构造主搜索对象 AMapSearchAPI，并设置代理。

第 5 步，设置输入提示查询的参数

请求参数类为 AMapInputTipsSearchRequest，keywords是必填参数。

第 6 步，发起输入提示语查询

第 7 步，在回调中处理数据

当检索成功时，会进到 onInputTipsSearchDone 回调函数中，通过解析 AMapInputTipsSearchResponse 对象获取输入提示词进行展示。

说明：

1）可以在回调中解析 response，获取提示词。

2）通过 response.tips 可以获取到 AMapTip 列表，Poi详细信息可参考 AMapTip 类（包含：adcode、district、name等信息）。