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