使用关键字和坐标查询POI信息(景点、火车站、飞机场、港口等)
接口代码 |
接口说明 |
数据类 |
getGeoPoiLookup |
POI搜索 |
GeoPoiBean |
接口参数说明
-
location
(必选)需要查询地区的名称,支持文字、以英文逗号分隔的经度,纬度坐标(十进制,最多支持小数点后两位)、LocationID或Adcode(仅限中国城市)。例如 location=北京
或 location=116.41,39.92
-
type
(必选)POI类型,可选择搜索某一类型的POI。
scenic
景点
CSTA
潮流站点
TSTA
潮汐站点
-
city
选择POI所在城市,可设定只搜索在特定城市内的POI信息。城市名称可以是文字或城市的LocationID。默认不限制特定城市。
城市名称为精准匹配,建议使用LocaitonID,如文字无法匹配,则数据返回为空。
-
number
返回结果的数量,取值范围1-20,默认返回10个结果。
-
lang
多语言设置,请阅读多语言文档,了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。
示例代码
QWeather.getGeoPoiLookup(Context context, String location, String city, int number, Type type, Lang lang, final OnResultGeoPoiListener listener);
QWeather.getGeoPoiLookup(Context context, String location, Type type, final QWeather.OnResultGeoPoiListener listener);
GeoPoiBean属性
属性 |
说明 |
示例值 |
getCode |
参考状态码 |
200 |
getPoiList |
城市数据 |
List<Poi> |
Refer
属性 |
说明 |
示例值 |
getSourcesList |
原始数据来源 |
QWeather |
getLicenseList |
使用许可 |
QWeather Developers License |
POI 基础信息
属性 |
说明 |
示例值 |
getName |
Poi名称 |
北京动物园 |
getId |
PoiID |
10101020006A |
getLon |
Poi经度 |
116.33000 |
getLat |
Poi纬度 |
39.93000 |
getAdm2 |
该Poi的上级行政区划名称 |
北京 |
getAdm1 |
该Poi所属一级行政区域 |
北京 |
getCountry |
该Poi所属国家名称 |
中国 |
getTz |
该Poi所在时区 |
Asia/Shanghai |
getUtcOffset |
该Poi目前与UTC时间偏移的小时数 |
+08:00 |
getIsDst |
该Poi是否当前处于夏令时,1 表示当前处于夏令时,0 表示当前不是夏令时 |
0 |
getType |
该Poi的属性 |
scenic |
getRank |
地区评分 |
10 |
getFxLink |
该Poi的天气预报网页链接 |
https://www.qweather.com |