Edit

POI Range

Platform: API iOS Android

POI Range API provides the ability to query all POI information within a specified area.

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(required)The comma-separated longitude and latitude (decimal, up to 2 decimal places) of the location to be queried. For example: location=116.41,39.92
  • type(required)Choose to search for a certain type of POI.
    • scenic Scenic Spot
    • CSTA Currents Station
    • TSTA Tide Station
  • key(required)API authentication key, please refer to How To Get Your Key. Support Signature Authentication. Example: key=12334567890ABC
  • radiusSet search radius, the value range is 1-50, in kilometers. 5 by default.
  • numberNumber of the results in response, from 1 to 20, 10 is the default.
  • langMulti-language setting, see language code for available value. If data does not match the language you set, it will return results in English or its native language.

Request Example

Scenic zone within a 10 km radius

curl -L -X GET --compressed 'https://geoapi.qweather.com/v2/poi/range?location=116.40528,39.90498&type=scenic&radius=10&key=YOUR_KEY'

Response

The response is in JSON format and is Gzip compressed, all fields are Strings.

{
  "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": "http://hfx.link/1"
    },
    {
      "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": "http://hfx.link/1"
    },
    {
      "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": "http://hfx.link/1"
    },
    {
      "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": "http://hfx.link/1"
    },
    {
      "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": "http://hfx.link/1"
    }
  ],
  "refer": {
    "sources": [
      "qweather.com"
    ],
    "license": [
      "commercial license"
    ]
  }
}
  • 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 for daylight saving time and 0 for 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