POI搜索

平台: API iOS Android

使用关键字和坐标查询POI信息(景点、火车站、飞机场、港口等)

接口代码 接口说明 数据类
getGeoPoiLookup POI搜索 GeoPoiBean

接口参数说明

  • location(必选)需要查询地区的名称,支持文字、以英文逗号分隔的经度,纬度坐标(十进制,最多支持小数点后两位)、LocationIDAdcode(仅限中国城市)。例如 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 接口状态 Status Code
getPoiList 城市数据 List<Poi>

Refer

属性 说明 示例值
getSourcesList 原始数据来源 qweather.com
getLicenseList 使用许可 commercial license

POI 基础信息

属性 说明 示例值
getName Poi名称 南山区
getId PoiID 101280604
getLon Poi经度 22.53122
getLat Poi纬度 113.92942
getAdm2 该Poi的上级行政区划名称 深圳市
getAdm1 该Poi所属一级行政区域 广东省
getCountry 该Poi所属国家名称 中国
getTz 该Poi所在时区 Asia/Shanghai
getUtcOffset 该Poi目前与UTC时间偏移的小时数 +08:00
getIsDst 该Poi是否当前处于夏令时,1 表示当前处于夏令时,0 表示当前不是夏令时 0
getType 该Poi的属性 city
getRank 地区评分 10