POI Range

Endpoint#

GET /geo/v2/poi/range

Parameters#

Query parameters

• 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 for Scenic Spot, TSTA for Tide Station
• radius Search radius from 1 to 50 kilometers. The default is 5 kilometers.
• number Number of the results in response, from 1 to 20, 10 is the default.
• lang Multi-language setting, please see Language to find out how our multi-language works and how to set up.

Request example#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/geo/v2/poi/range?location=116.41%2C39.92&type=scenic&radius=10&number=10&lang=en'

Replace your_token and your_api_host with your JWT Authentication and API Host

Try it

Response#

{
  "code": "200",
  "poi": [
    {
      "name": "Nanluoguxiang Alley",
      "id": "10101010005A",
      "lat": "39.93000",
      "lon": "116.40000",
      "adm2": "Beijing",
      "adm1": "Beijing",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "86",
      "fxLink": "https://www.qweather.com/en"
    },
    {
      "name": "Jingshan Park",
      "id": "10101010012A",
      "lat": "39.92000",
      "lon": "116.39000",
      "adm2": "Beijing",
      "adm1": "Beijing",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "67",
      "fxLink": "https://www.qweather.com/en"
    },
    {
      "name": "Zhongshan Park",
      "id": "10101010016A",
      "lat": "39.91000",
      "lon": "116.39000",
      "adm2": "Beijing",
      "adm1": "Beijing",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "86",
      "fxLink": "https://www.qweather.com/en"
    },
    {
      "name": "The Palace Museum",
      "id": "10101010018A",
      "lat": "39.91000",
      "lon": "116.39000",
      "adm2": "Beijing",
      "adm1": "Beijing",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "67",
      "fxLink": "https://www.qweather.com/en"
    },
    {
      "name": "Beijing Imperial Academy",
      "id": "10101010006A",
      "lat": "39.94000",
      "lon": "116.41000",
      "adm2": "Beijing",
      "adm1": "Beijing",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "68",
      "fxLink": "https://www.qweather.com/en"
    }
  ],
  "refer": {
    "sources": [
      "https://developer.qweather.com/attribution.html"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

• code string Status code
• poi object POI list
  • name string Location Name
  • id string Location ID
  • lat string Latitude
  • lon string Longitude
  • adm2 string Name of the superior administrative division of the location
  • adm1 string The first-level administrative area of ​​the location
  • country string Country name
  • tz string Timezone for this location
  • utcOffset string The number of hours offset between local time and UTC time, refer to UTC Offset
  • isDst string Is the location currently on daylight saving time. 1 for daylight saving time and 0 for not in daylight saving time
  • type string Location type
  • rank string Location rank
  • fxLink uri Responsive web page of this location, easy to embed in your website or APP
• refer object Data sources and licensing information
  • sources array Data source and other statements, may be null
  • license array Data license, may be null