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 Spot
CSTA Currents Station
TSTA 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, default
en English
fr French
es Spanish
ja Japanese
ko 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 `1` in daylight saving time `0` not in daylight saving time
`poi.type`	POI type
`poi.rank`	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