POI Range
POI Range API provides the ability to query all POI information within a specified area, making it easy to display POI weather data within an area.
GeoAPI is free for the first 50,000 calls per day for each account, more calls refer to price
Request URL #
https://geoapi.qweather.com/v2/poi/range?[params]
Request Parameters #
All parameters are separated by &
. If no optional parameters are set, the default value will be used.
location
The comma-separated longitude and latitude of the location to be queried.
For example: location=116.41,39.92
type
Choose to search for a certain type of POI.
scenic
Scenic SpotCSTA
Currents StationTSTA
Tide Station
key
API authentication key, please refer to How To Get Your Key. Support Signature Authentication.
For example: key=12334567890ABC
radius
Set search radius, the value range is 1-50, in kilometers. 5 by default.
number
Number of the results in response, from 1 to 20, 10 is the default
lang
Multi-language setting, if data does not match the language you set, it will return results in English or its native language.
zh
Chinese, defaulten
Englishfr
Frenches
Spanishja
Japaneseko
Korean- See more language code
Response #
// Scenic zone within a 10 km radius
// https://geoapi.qweather.com/v2/poi/range?location=116.40528,39.90498&type=scenic&radius=10&lang=en&key=YOUR_KEY
{
"code": "200",
"poi": [
{
"name": "Zhongshan Park",
"id": "10101010016A",
"lat": "39.90999985",
"lon": "116.38999939",
"adm2": "Beijing",
"adm1": "Beijing",
"country": "China",
"tz": "Asia/Shanghai",
"utcOffset": "+08:00",
"isDst": "0",
"type": "scenic",
"rank": "86",
"fxLink": "http://hfx.link/1"
},
{
"name": "The Palace Museum",
"id": "10101010018A",
"lat": "39.90999985",
"lon": "116.38999939",
"adm2": "Beijing",
"adm1": "Beijing",
"country": "China",
"tz": "Asia/Shanghai",
"utcOffset": "+08:00",
"isDst": "0",
"type": "scenic",
"rank": "67",
"fxLink": "http://hfx.link/1"
},
{
"name": "Beijing Planning Exhibition Hall",
"id": "10101010002A",
"lat": "39.88999939",
"lon": "116.40000153",
"adm2": "Beijing",
"adm1": "Beijing",
"country": "China",
"tz": "Asia/Shanghai",
"utcOffset": "+08:00",
"isDst": "0",
"type": "scenic",
"rank": "68",
"fxLink": "http://hfx.link/1"
},
{
"name": "Lao She Teahouse",
"id": "10101010021A",
"lat": "39.88999939",
"lon": "116.38999939",
"adm2": "Beijing",
"adm1": "Beijing",
"country": "China",
"tz": "Asia/Shanghai",
"utcOffset": "+08:00",
"isDst": "0",
"type": "scenic",
"rank": "86",
"fxLink": "http://hfx.link/1"
},
{
"name": "Jingshan Park",
"id": "10101010012A",
"lat": "39.91999817",
"lon": "116.38999939",
"adm2": "Beijing",
"adm1": "Beijing",
"country": "China",
"tz": "Asia/Shanghai",
"utcOffset": "+08:00",
"isDst": "0",
"type": "scenic",
"rank": "67",
"fxLink": "http://hfx.link/1"
}
],
"refer": {
"sources": [
"qweather.com"
],
"license": [
"commercial license"
]
}
}
Parameters | Description |
---|---|
code |
API status code, please refer to Status Code |
poi.name |
POI Name |
poi.id |
POI ID |
poi.lat |
Latitude of the POI |
poi.lon |
Longitude of the POI |
poi.adm2 |
Name of the superior administrative division of the POI |
poi.adm1 |
The first-level administrative area of the POI |
poi.country |
Country name of the POI |
poi.tz |
POI timezone |
poi.utcOffset |
The number of hours offset between local time and UTC time, refer to UTC Offset |
poi.isDst |
Is the POI currently on daylight saving time |
poi.type |
POI type |
poi.rank |
|
poi.fxLink |
Responsive web page of this location, easy to embed in your website or APP |
refer.sources |
Data source and other statements, may be null |
refer.license |
Data license, may be null |