编辑

POI范围搜索

平台: API iOS Android

提供指定区域范围内查询所有POI信息。

请求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公里景点

curl -L -X GET --compressed 'https://geoapi.qweather.com/v2/poi/range?location=116.40528,39.90498&type=scenic&radius=10&key=YOUR_KEY'

返回数据

返回数据是JSON格式并进行了Gzip压缩，数据类型均为字符串。

{
  "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 数据许可或版权声明，可能为空