POI Range

Endpoint#

GET /geo/v2/poi/range

Parameters#

Query parameters

• location ^required

  string

  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

  string

  Choose to search for a certain type of POI. scenic for Scenic Spot, TSTA for Tide Station
• radius

  number

  Search radius from 1 to 50 kilometers. The default is 5 kilometers.
• number

  integer

  Number of the results in response, from 1 to 20, 10 is the default.
• lang

  string

  Language setting. See Language for behavior, configuration, and data availability

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'

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

    Whether the location is observing daylight saving time: 1 for daylight saving time, 0 otherwise
  • 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