POI范围搜索
提供指定区域范围内查询所有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": "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
数据许可或版权声明,可能为空