POI范围搜索

提供指定区域范围内查询所有POI信息,方便显示某一区域内的POI天气数据。

GeoAPI每天每个账号下所有应用前50000次免费,超出部分参考计费方式

请求URL

https://geoapi.qweather.com/v2/poi/range?[请求参数]

请求参数

请求参数包括必选和可选参数,如不填写可选参数将使用其默认值,参数之间使用&进行分隔。

location

需要查询地区的以英文逗号分隔的经度,纬度坐标(十进制)。例如 location=116.41,39.92

type

POI类型,可选择搜索某一类型的POI。

  • scenic 景点
  • CSTA 潮流站点
  • TSTA 潮汐站点
key

用户认证key,请参考如何获取你的KEY。支持数字签名方式进行认证。例如 key=123456789ABC

radius

搜索范围,可设置搜索半径,取值范围1-50,单位:公里。默认5公里

number

返回结果的数量,取值范围1-20,默认返回10个结果

lang

多语言设置,默认中文,当数据不匹配你设置的语言时,将返回英文或其本地语言结果。

返回数据

// 北京市中心附近10公里景点 
// https://geoapi.qweather.com/v2/poi/range?location=116.40528,39.90498&type=scenic&radius=10&key=你的KEY

{
  "code": "200",
  "poi": [
    {
      "name": "中山公园",
      "id": "10101010016A",
      "lat": "39.90999985",
      "lon": "116.38999939",
      "adm2": "北京",
      "adm1": "北京",
      "country": "中国",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "86",
      "fxLink": "http://hfx.link/1"
    },
    {
      "name": "故宫博物院",
      "id": "10101010018A",
      "lat": "39.90999985",
      "lon": "116.38999939",
      "adm2": "北京",
      "adm1": "北京",
      "country": "中国",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "67",
      "fxLink": "http://hfx.link/1"
    },
    {
      "name": "北京市规划展览馆",
      "id": "10101010002A",
      "lat": "39.88999939",
      "lon": "116.40000153",
      "adm2": "北京",
      "adm1": "北京",
      "country": "中国",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "68",
      "fxLink": "http://hfx.link/1"
    },
    {
      "name": "老舍茶馆",
      "id": "10101010021A",
      "lat": "39.88999939",
      "lon": "116.38999939",
      "adm2": "北京",
      "adm1": "北京",
      "country": "中国",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "86",
      "fxLink": "http://hfx.link/1"
    },
    {
      "name": "景山公园",
      "id": "10101010012A",
      "lat": "39.91999817",
      "lon": "116.38999939",
      "adm2": "北京",
      "adm1": "北京",
      "country": "中国",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "67",
      "fxLink": "http://hfx.link/1"
    }
  ],
  "refer": {
    "sources": [
      "qweather.com"
    ],
    "license": [
      "commercial license"
    ]
  }
}
参数 描述
code

API状态码,具体含义请参考状态码

poi.name

POI(兴趣点)名称

poi.id

POI(兴趣点)ID

poi.lat

POI(兴趣点)纬度

poi.lon

POI(兴趣点)经度

poi.adm2

POI(兴趣点)的上级行政区划名称

poi.adm1

POI(兴趣点)所属一级行政区域

poi.country

POI(兴趣点)所属国家名称

poi.tz

POI(兴趣点)所在时区

poi.utcOffset

POI(兴趣点)目前与UTC时间偏移的小时数,参考详细说明

poi.isDst

POI(兴趣点)是否当前处于夏令时
1 表示当前处于夏令时
0 表示当前不是夏令时

poi.type

POI(兴趣点)的属性

poi.rank

地区评分

poi.fxLink

该地区的天气预报网页链接,便于嵌入你的网站或应用

refer.sources

原始数据来源,或数据源说明,可能为空

refer.license

数据许可或版权声明,可能为空