com.amap.api.services.poisearch

类 PoiSearch

java.lang.Object

com.amap.api.services.poisearch.PoiSearch

已过时。

自v9.4.0废弃,推荐使用 PoiSearchV2
Deprecated since v9.4.0, recommend using PoiSearchV2

public class PoiSearch
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.

从以下版本开始:

V2.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，会返回完整参数 The extension field 'all' will return complete parameters.
static java.lang.String	EXTENSIONS_BASE 已过时。 扩展字段base，会返回部分参数 The extension field 'base' will return partial parameters.

构造器概要

构造器

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

方法概要

限定符和类型	方法和说明
PoiSearch.SearchBound	getBound() 已过时。 返回查询矩形。
java.lang.String	getLanguage() 已过时。 自V2.5.0后废弃，请参考 ServiceSettings.getLanguage() Deprecated since V2.5.0, please refer to ServiceSettings.getLanguage()
PoiSearch.Query	getQuery() 已过时。 返回查询条件。
PoiResult	searchPOI() 已过时。 查询POI。
void	searchPOIAsyn() 已过时。 查询POI异步接口。
PoiItem	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(PoiSearch.SearchBound bnd) 已过时。 设置查询矩形。
void	setLanguage(java.lang.String language) 已过时。 自V2.5.0后废弃，请参考 ServiceSettings.setLanguage(String) Deprecated since V2.5.0, please refer to ServiceSettings.setLanguage(String)
void	setOnPoiSearchListener(PoiSearch.OnPoiSearchListener listener) 已过时。 设置查询监听接口。
void	setQuery(PoiSearch.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.

从以下版本开始:

V2.3.1

另请参阅:

常量字段值

CHINESE

public static final java.lang.String CHINESE

已过时。

语言设置常量。
Language setting constant.

从以下版本开始:

V2.3.1

另请参阅:

常量字段值

EXTENSIONS_ALL

public static final java.lang.String EXTENSIONS_ALL

已过时。

扩展字段all，会返回完整参数
The extension field 'all' will return complete parameters.

从以下版本开始:

7.6.0

另请参阅:

常量字段值

EXTENSIONS_BASE

public static final java.lang.String EXTENSIONS_BASE

已过时。

扩展字段base，会返回部分参数
The extension field 'base' will return partial parameters.

从以下版本开始:

7.6.0

另请参阅:

常量字段值

构造器详细资料

PoiSearch

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

已过时。

根据给定的参数构造一个PoiSearch 的新对象。
Construct a new PoiSearch object based on the given parameters.

参数:

context - 对应的Context。
Corresponding Context.

query - 查询条件。
Query conditions.

抛出:

AMapException

从以下版本开始:

V2.0.0

方法详细资料

setOnPoiSearchListener

public void setOnPoiSearchListener(PoiSearch.OnPoiSearchListener listener)

已过时。

设置查询监听接口。
Set the query listener interface.

参数:

listener - 查询监听接口。
query listener interface.

从以下版本开始:

V2.1.0

setLanguage

public void setLanguage(java.lang.String language)

已过时。 自V2.5.0后废弃，请参考 ServiceSettings.setLanguage(String)
Deprecated since V2.5.0, please refer to ServiceSettings.setLanguage(String)

设置POI搜索返回结果语言。
Set the language for POI search results.

参数:

language - 支持ENGLISH和CHINESE。
Supports ENGLISH and CHINESE.

从以下版本开始:

V2.3.1

getLanguage

public java.lang.String getLanguage()

已过时。 自V2.5.0后废弃，请参考 ServiceSettings.getLanguage()
Deprecated since V2.5.0, please refer to ServiceSettings.getLanguage()

从以下版本开始:

V2.3.1

searchPOI

public PoiResult 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

从以下版本开始:

V2.0.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.

从以下版本开始:

V2.1.0

searchPOIId

public PoiItem 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

从以下版本开始:

V2.8.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.

从以下版本开始:

V2.8.0

setQuery

public void setQuery(PoiSearch.Query query)

已过时。

设置查询条件。
Set query conditions.

参数:

query - 新的查询条件。
New query conditions.

从以下版本开始:

V2.0.0

setBound

public void setBound(PoiSearch.SearchBound bnd)

已过时。

设置查询矩形。
Set the query bounding box.

参数:

bnd - 新的查询矩形。
New query bounding box.

从以下版本开始:

V2.0.0

getQuery

public PoiSearch.Query getQuery()

已过时。

返回查询条件。
Return query conditions.

返回:

查询条件。
Query conditions.

从以下版本开始:

V2.0.0

getBound

public PoiSearch.SearchBound getBound()

已过时。

返回查询矩形。
Return the query bounding box.

返回:

查询矩形。
Query bounding box.

从以下版本开始:

V2.0.0