com.amap.api.services.poisearch

## 类 PoiSearch

- java.lang.Object
- - com.amap.api.services.poisearch.PoiSearch

- 已过时。
  自v9.4.0废弃,推荐使用 `PoiSearchV2`

      public class PoiSearch
      extends java.lang.Object

  本类为POI（Point Of Interest，兴趣点）搜索的“入口”类，定义此类，开始搜索。在类PoiSearch 中，还定义了两个内部类，Query 与SearchBound，请用这两个内部类设定搜索参数。
  从以下版本开始:
    2.0.0

- - ### 嵌套类概要

    嵌套类
    限定符和类型 | 类和说明
    --- | ---
    `static interface` | `PoiSearch.OnPoiSearchListener` 已过时。 本类为POI（Point Of Interest，兴趣点）搜索结果的异步处理回调接口。
    `static class` | `PoiSearch.Query` 已过时。 此类定义了搜索的关键字，类别及城市。
    `static class` | `PoiSearch.SearchBound` 已过时。 此类定义了查询圆形和查询矩形，查询返回的POI的位置在此圆形或矩形内。

  - ### 字段概要

    字段
    限定符和类型 | 字段和说明
    --- | ---
    `static java.lang.String` | `CHINESE` 已过时。 语言设置常量。
    `static java.lang.String` | `ENGLISH` 已过时。 语言设置常量。
    `static java.lang.String` | `EXTENSIONS_ALL` 已过时。 扩展字段all，会返回完整参数
    `static java.lang.String` | `EXTENSIONS_BASE` 已过时。 扩展字段base，会返回部分参数

  - ### 构造器概要

    构造器
    构造器和说明
    `PoiSearch(Context context, PoiSearch.Query query)` 已过时。 根据给定的参数构造一个PoiSearch 的新对象。

  - ### 方法概要

    所有方法 实例方法 具体方法 已过时的方法
    限定符和类型 | 方法和说明
    --- | ---
    `PoiSearch.SearchBound` | `getBound()` 已过时。 返回查询矩形。
    `java.lang.String` | `getLanguage()` 已过时。 自V2.5.0后废弃，请参考 `ServiceSettings.getLanguage()`
    `PoiSearch.Query` | `getQuery()` 已过时。 返回查询条件。
    `PoiResult` | `searchPOI()` 已过时。 查询POI。
    `void` | `searchPOIAsyn()` 已过时。 查询POI异步接口。
    `PoiItem` | `searchPOIId(java.lang.String poiID)` 已过时。 已知poiid信息（点击地图底图），搜索POI的详细信息，同步
    `void` | `searchPOIIdAsyn(java.lang.String poiID)` 已过时。 已知poiid信息（点击地图底图），搜索POI的详细信息，异步
    `void` | `setBound(PoiSearch.SearchBound bnd)` 已过时。 设置查询矩形。
    `void` | `setLanguage(java.lang.String language)` 已过时。 自V2.5.0后废弃，请参考 `ServiceSettings.setLanguage(String)`
    `void` | `setOnPoiSearchListener(PoiSearch.OnPoiSearchListener listener)` 已过时。 设置查询监听接口。
    `void` | `setQuery(PoiSearch.Query query)` 已过时。 设置查询条件。

    - ### 从类继承的方法 java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### 字段详细资料

    - #### ENGLISH

          public static final java.lang.String ENGLISH

      已过时。
      语言设置常量。
      从以下版本开始:
        2.3.1
      另请参阅:
        常量字段值

    - #### CHINESE

          public static final java.lang.String CHINESE

      已过时。
      语言设置常量。
      从以下版本开始:
        2.3.1
      另请参阅:
        常量字段值

    - #### EXTENSIONS_ALL

          public static final java.lang.String EXTENSIONS_ALL

      已过时。
      扩展字段all，会返回完整参数
      从以下版本开始:
        7.6.0
      另请参阅:
        常量字段值

    - #### EXTENSIONS_BASE

          public static final java.lang.String EXTENSIONS_BASE

      已过时。
      扩展字段base，会返回部分参数
      从以下版本开始:
        7.6.0
      另请参阅:
        常量字段值

  - ### 构造器详细资料

    - #### PoiSearch

          public PoiSearch(Context context,
                           PoiSearch.Query query)
                    throws AMapException

      已过时。
      根据给定的参数构造一个PoiSearch 的新对象。
      参数:
        `context` - 对应的Context。
        `query` - 查询条件。
      抛出:
        `AMapException`
      从以下版本开始:
        2.0.0

  - ### 方法详细资料

    - #### setOnPoiSearchListener

          public void setOnPoiSearchListener(PoiSearch.OnPoiSearchListener listener)

      已过时。
      设置查询监听接口。
      参数:
        `listener` - 查询监听接口。
      从以下版本开始:
        2.1.0

    - #### setLanguage

          public void setLanguage(java.lang.String language)

      已过时。 自V2.5.0后废弃，请参考 `ServiceSettings.setLanguage(String)`
      设置POI搜索返回结果语言。
      参数:
        `language` - 支持ENGLISH和CHINESE。
      从以下版本开始:
        2.3.1

    - #### getLanguage

          public java.lang.String getLanguage()

      已过时。 自V2.5.0后废弃，请参考 `ServiceSettings.getLanguage()`
      从以下版本开始:
        2.3.1

    - #### searchPOI

          public PoiResult searchPOI()
                              throws AMapException

      已过时。
      查询POI。

      如果此时矩形查询（SearchBound）已定义，则搜索范围为该矩形内的符合条件的POI，否则如果此时查询条件（Query）中的行政区划代码已定义，则搜索该城市（地区）内的所有符合条件的POI,如上述两个条件均未定义，则搜索范围为全国。为了性能及结果的清晰，强烈建议定义一个范围：矩形或行政区划代码均可。整个查询的语义为查找符合查询关键字， 符合查询类型编码组合及在指定范围内的所有POI。

      此接口在网络连接出现问题的情况下，会抛出AMapException。

      返回:
        查询POI 的结果，结果是分页的，每页最多30 个。通过类PoiPagedResult 的实例可以检索每一页。
      抛出:
        `AMapException。`
        `AMapException`
      从以下版本开始:
        2.0.0

    - #### searchPOIAsyn

          public void searchPOIAsyn()

      已过时。
      查询POI异步接口。 如果此时矩形查询（SearchBound）已定义，则搜索范围为该矩形内的符合条件的POI，否则如果此时查询条件（Query）中的行政区划代码已定义，则搜索该城市（地区）内的所有符合条件的POI,如上述两个条件均未定义，则搜索范围为全国。建议定义一个范围：矩形或行政区划代码均可。整个查询的语义为查找符合查询关键字， 符合查询类型编码组合及在指定范围内的指定POI。查询POI 的结果，结果是分页的，每页最多30 个。 此方法为异步处理。
      从以下版本开始:
        2.1.0

    - #### searchPOIId

          public PoiItem searchPOIId(java.lang.String poiID)
                              throws AMapException

      已过时。
      已知poiid信息（点击地图底图），搜索POI的详细信息，同步
      参数:
        `poiID` - poi的ID
      返回:
        poi的信息，如POI名称、类型、城市编码等。
      抛出:
        `AMapException`
      从以下版本开始:
        2.8.0

    - #### searchPOIIdAsyn

          public void searchPOIIdAsyn(java.lang.String poiID)

      已过时。
      已知poiid信息（点击地图底图），搜索POI的详细信息，异步
      参数:
        `poiID` - poi的ID
      从以下版本开始:
        2.8.0

    - #### setQuery

          public void setQuery(PoiSearch.Query query)

      已过时。
      设置查询条件。
      参数:
        `query` - 新的查询条件。
      从以下版本开始:
        2.0.0

    - #### setBound

          public void setBound(PoiSearch.SearchBound bnd)

      已过时。
      设置查询矩形。
      参数:
        `bnd` - 新的查询矩形。
      从以下版本开始:
        2.0.0

    - #### getQuery

          public PoiSearch.Query getQuery()

      已过时。
      返回查询条件。
      返回:
        查询条件。
      从以下版本开始:
        2.0.0

    - #### getBound

          public PoiSearch.SearchBound getBound()

      已过时。
      返回查询矩形。
      返回:
        查询矩形。
      从以下版本开始:
        2.0.0