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.

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