PoiSearchV2

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

```
public class PoiSearchV2
extends java.lang.Object
```
本类为POI（Point Of Interest，兴趣点）搜索的“入口”类，定义此类，开始搜索。在类PoiSearch 中，还定义了两个内部类，Query 与SearchBound，请用这两个内部类设定搜索参数。
This class is the 'entry' class for POI (Point Of Interest) search. Define this class to start the search. In the PoiSearch class, two inner classes, Query and SearchBound, are also defined. Please use these two inner classes to set search parameters.

从以下版本开始:

V9.4.0

嵌套类概要

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

字段概要

字段
限定符和类型字段和说明

static java.lang.String CHINESE
语言设置常量。

static java.lang.String ENGLISH
语言设置常量。

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

构造器概要

构造器
构造器和说明

PoiSearchV2(android.content.Context context, PoiSearchV2.Query query)
根据给定的参数构造一个PoiSearch 的新对象。

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

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`PoiSearchV2.SearchBound`	`getBound()` 返回查询矩形。
`PoiSearchV2.Query`	`getQuery()` 返回查询条件。
`PoiResultV2`	`searchPOI()` 查询POI。
`void`	`searchPOIAsyn()` 查询POI异步接口。
`VisualSearchResult`	`searchPOIByVisual(com.amap.api.services.poisearch.PoiSearchV2.VisualQuery visualQuery)` 通过图片进行视觉识别搜索 POI（同步）。
`void`	`searchPOIByVisualAsyn(com.amap.api.services.poisearch.PoiSearchV2.VisualQuery visualQuery)` 通过图片进行视觉识别搜索 POI（异步）。
`PoiItemV2`	`searchPOIId(java.lang.String poiID)` 已知poiid信息（点击地图底图），搜索POI的详细信息，同步 Search for detailed POI information based on a known POI ID (click on the base map), synchronous.
`void`	`searchPOIIdAsyn(java.lang.String poiID)` 已知poiid信息（点击地图底图），搜索POI的详细信息，异步 Search for detailed POI information based on a known POI ID (click on the base map), asynchronous.
`void`	`setBound(PoiSearchV2.SearchBound bnd)` 设置查询矩形。
`void`	`setOnPoiSearchListener(PoiSearchV2.OnPoiSearchListener listener)` 设置查询监听接口。
`void`	`setQuery(PoiSearchV2.Query query)` 设置查询条件。

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - ENGLISH
```
public static final java.lang.String ENGLISH
```
    语言设置常量。
    Language setting constant.
    
    从以下版本开始:
    
    V9.4.0
    
    另请参阅:
    
    常量字段值
  - CHINESE
```
public static final java.lang.String CHINESE
```
    语言设置常量。
    Language setting constant.
    
    从以下版本开始:
    
    V9.4.0
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - PoiSearchV2
```
public PoiSearchV2(android.content.Context context,
                   PoiSearchV2.Query query)
            throws AMapException
```
    根据给定的参数构造一个PoiSearch 的新对象。
    Construct a new PoiSearch object based on the given parameters.
    
    参数:
    
    context - 对应的Context。
    Corresponding Context.
    
    query - 查询条件。
    Query conditions.
    
    抛出:
    
    AMapException
    
    从以下版本开始:
    
    V9.4.0
- 方法详细资料
  - setOnPoiSearchListener
```
public void setOnPoiSearchListener(PoiSearchV2.OnPoiSearchListener listener)
```
    设置查询监听接口。
    Set the query listener interface.
    
    参数:
    
    listener - 查询监听接口。
    query listener interface.
    
    从以下版本开始:
    
    V9.4.0
  - searchPOI
```
public PoiResultV2 searchPOI()
                      throws AMapException
```
    查询POI。
    如果此时矩形查询（SearchBound）已定义，则搜索范围为该矩形内的符合条件的POI，否则如果此时查询条件（Query）中的行政区划代码已定义，则搜索该城市（地区）内的所有符合条件的POI,如上述两个条件均未定义，则搜索范围为全国。为了性能及结果的清晰，强烈建议定义一个范围：矩形或行政区划代码均可。整个查询的语义为查找符合查询关键字，符合查询类型编码组合及在指定范围内的所有POI。
    
    此接口在网络连接出现问题的情况下，会抛出AMapException。
    
    Query POI.
    If a rectangular query (SearchBound) is defined at this time, the search scope will be the POIs that meet the conditions within that rectangle. Otherwise, if the administrative division code in the query condition (Query) is defined, all POIs that meet the conditions within that city (region) will be searched. If neither of the above two conditions is defined, the search scope will be nationwide. For performance and clarity of results, it is strongly recommended to define a scope: either a rectangle or an administrative division code. The semantics of the entire query is to find all POIs that match the query keywords, match the query type code combination, and are within the specified range.
    
    This interface will throw an AMapException in case of network connection issues.
    
    返回:
    
    查询POI 的结果，结果是分页的，每页最多30 个。通过类PoiPagedResult 的实例可以检索每一页。
    The query results for POIs are paginated, with a maximum of 30 items per page. Each page can be retrieved through an instance of the PoiPagedResult class.
    
    抛出:
    
    AMapException。
    
    AMapException
    
    从以下版本开始:
    
    V9.4.0
  - searchPOIAsyn
```
public void searchPOIAsyn()
```
    查询POI异步接口。如果此时矩形查询（SearchBound）已定义，则搜索范围为该矩形内的符合条件的POI，否则如果此时查询条件（Query）中的行政区划代码已定义，则搜索该城市（地区）内的所有符合条件的POI,如上述两个条件均未定义，则搜索范围为全国。建议定义一个范围：矩形或行政区划代码均可。整个查询的语义为查找符合查询关键字，符合查询类型编码组合及在指定范围内的指定POI。查询POI 的结果，结果是分页的，每页最多30 个。此方法为异步处理。
    Asynchronous POI query interface. If a bounding box (SearchBound) is defined, the search scope is limited to POIs within that box. If an administrative division code is defined in the query conditions (Query), the search scope is limited to POIs within that city (region). If neither condition is defined, the search is conducted nationwide. It is recommended to define a scope, either a bounding box or an administrative division code. The query semantics are to find POIs that match the query keywords, the query type code combination, and are within the specified scope. The query results for POIs are paginated, with a maximum of 30 items per page. This method is processed asynchronously.
    
    从以下版本开始:
    
    V9.4.0
  - searchPOIId
```
public PoiItemV2 searchPOIId(java.lang.String poiID)
                      throws AMapException
```
    已知poiid信息（点击地图底图），搜索POI的详细信息，同步
    Search for detailed POI information based on a known POI ID (click on the base map), synchronous.
    
    参数:
    
    poiID - poi的ID
    The ID of the POI.
    
    返回:
    
    poi的信息，如POI名称、类型、城市编码等。
    POI information, such as POI name, type, city code, etc.
    
    抛出:
    
    AMapException
    
    从以下版本开始:
    
    V9.4.0
  - searchPOIIdAsyn
```
public void searchPOIIdAsyn(java.lang.String poiID)
```
    已知poiid信息（点击地图底图），搜索POI的详细信息，异步
    Search for detailed POI information based on a known POI ID (click on the base map), asynchronous.
    
    参数:
    
    poiID - poi的ID
    The ID of the POI.
    
    从以下版本开始:
    
    V9.4.0
  - searchPOIByVisual
```
public VisualSearchResult searchPOIByVisual(com.amap.api.services.poisearch.PoiSearchV2.VisualQuery visualQuery)
                                     throws AMapException
```
    通过图片进行视觉识别搜索 POI（同步）。将图片发送至服务端进行视觉识别，返回识别到的 POI 结果。此接口在网络连接出现问题的情况下，会抛出 AMapException。
    
    参数:
    
    visualQuery - 视觉识别查询参数，包含图片地址和用户位置。
    
    返回:
    
    视觉识别搜索结果。
    
    抛出:
    
    AMapException - 网络异常或参数错误时抛出。
    
    从以下版本开始:
    
    V9.7.0
  - searchPOIByVisualAsyn
```
public void searchPOIByVisualAsyn(com.amap.api.services.poisearch.PoiSearchV2.VisualQuery visualQuery)
```
    通过图片进行视觉识别搜索 POI（异步）。结果通过 PoiSearchV2.OnPoiSearchListener.onVisualSearched(VisualSearchResult, int) 回调返回。
    
    参数:
    
    visualQuery - 视觉识别查询参数，包含图片地址和用户位置。
    
    从以下版本开始:
    
    V9.7.0
  - setQuery
```
public void setQuery(PoiSearchV2.Query query)
```
    设置查询条件。
    Set query conditions.
    
    参数:
    
    query - 新的查询条件。
    New query conditions.
    
    从以下版本开始:
    
    V9.4.0
  - setBound
```
public void setBound(PoiSearchV2.SearchBound bnd)
```
    设置查询矩形。
    Set the query bounding box.
    
    参数:
    
    bnd - 新的查询矩形。
    New query bounding box.
    
    从以下版本开始:
    
    V9.4.0
  - getQuery
```
public PoiSearchV2.Query getQuery()
```
    返回查询条件。
    Return query conditions.
    
    返回:
    
    查询条件。
    Query conditions.
    
    从以下版本开始:
    
    V9.4.0
  - getBound
```
public PoiSearchV2.SearchBound getBound()
```
    返回查询矩形。
    Return the query bounding box.
    
    返回:
    
    查询矩形。
    Query bounding box.
    
    从以下版本开始:
    
    V9.4.0

类 PoiSearchV2

嵌套类概要

字段概要

构造器概要

方法概要

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

字段详细资料

ENGLISH

CHINESE

构造器详细资料

PoiSearchV2

方法详细资料

setOnPoiSearchListener

searchPOI

searchPOIAsyn

searchPOIId

searchPOIIdAsyn

searchPOIByVisual

searchPOIByVisualAsyn

setQuery

setBound

getQuery

getBound