POI范围搜索

平台: API iOS Android

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

请求路径

/geo/v2/poi/range

参数

查询参数

location(必选)需要查询地区的以英文逗号分隔的经度,纬度坐标（十进制，最多支持小数点后两位）。例如 location=116.41,39.92
type(必选)POI类型，可选择搜索某一类型的POI。
- scenic 景点
- CSTA 潮流站点
- TSTA 潮汐站点
radius搜索范围，可设置搜索半径，取值范围1-50，单位：公里。默认5公里。
number返回结果的数量，取值范围1-20，默认返回10个结果。
lang多语言设置，请阅读多语言文档，了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。

请求示例

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your_api_host/geo/v2/poi/range?location=116.40528,39.90498&type=scenic&radius=10'

请将your_token替换为你的JWT身份认证，将your_api_host替换为你的API Host

返回数据

返回数据是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": "https://www.qweather.com"
    },
    {
      "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": "https://www.qweather.com"
    },
    {
      "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": "https://www.qweather.com"
    },
    {
      "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": "https://www.qweather.com"
    },
    {
      "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": "https://www.qweather.com"
    }
  ],
  "refer": {
    "sources": [
      "QWeather"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

code 请参考状态码
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 数据许可或版权声明，可能为空