com.amap.api.services.poisearch

## 类 PoiSearchV2

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

-     public class PoiSearchV2
      extends java.lang.Object

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

- - ### 嵌套类概要

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

  - ### 字段概要

    字段
    限定符和类型 | 字段和说明
    --- | ---
    `static java.lang.String` | `CHINESE` 语言设置常量。
    `static java.lang.String` | `ENGLISH` 语言设置常量。

  - ### 构造器概要

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

  - ### 方法概要

    所有方法 实例方法 具体方法
    限定符和类型 | 方法和说明
    --- | ---
    `PoiSearchV2.SearchBound` | `getBound()` 返回查询矩形。
    `PoiSearchV2.Query` | `getQuery()` 返回查询条件。
    `PoiResultV2` | `searchPOI()` 查询POI。
    `void` | `searchPOIAsyn()` 查询POI异步接口。
    `PoiItemV2` | `searchPOIId(java.lang.String poiID)` 已知poiid信息（点击地图底图），搜索POI的详细信息，同步
    `void` | `searchPOIIdAsyn(java.lang.String poiID)` 已知poiid信息（点击地图底图），搜索POI的详细信息，异步
    `void` | `setBound(PoiSearchV2.SearchBound bnd)` 设置查询矩形。
    `void` | `setOnPoiSearchListener(PoiSearchV2.OnPoiSearchListener listener)` 设置查询监听接口。
    `void` | `setQuery(PoiSearchV2.Query query)` 设置查询条件。

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

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

- - ### 字段详细资料

    - #### ENGLISH

          public static final java.lang.String ENGLISH

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

    - #### CHINESE

          public static final java.lang.String CHINESE

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

  - ### 构造器详细资料

    - #### PoiSearchV2

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

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

  - ### 方法详细资料

    - #### setOnPoiSearchListener

          public void setOnPoiSearchListener(PoiSearchV2.OnPoiSearchListener listener)

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

    - #### searchPOI

          public PoiResultV2 searchPOI()
                                throws AMapException

      查询POI。

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

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

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

    - #### searchPOIAsyn

          public void searchPOIAsyn()

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

    - #### searchPOIId

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

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

    - #### searchPOIIdAsyn

          public void searchPOIIdAsyn(java.lang.String poiID)

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

    - #### setQuery

          public void setQuery(PoiSearchV2.Query query)

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

    - #### setBound

          public void setBound(PoiSearchV2.SearchBound bnd)

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

    - #### getQuery

          public PoiSearchV2.Query getQuery()

      返回查询条件。
      返回:
        查询条件。
      从以下版本开始:
        9.4.0

    - #### getBound

          public PoiSearchV2.SearchBound getBound()

      返回查询矩形。
      返回:
        查询矩形。
      从以下版本开始:
        9.4.0