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