POI Lookup

POI Lookup API provides basic information of POI(scenic spot, tide stations, currents stations, etc.)

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/lookup?[params]

Request Parameters #

All parameters are separated by &. If no optional parameters are set, the default value will be used.

location

The location to be queried, support text, LocationID, comma-separated longitude and latitude, Adcode(Chinese cities only).

For example: location=beijing or 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

city

Search for POI within a given city. The city name can be text or the city’s LocationID.

The city name is an exact match. It is recommended to use LocaitonID. If the text cannot be matched, the data returned will be empty.

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 #

// Lookup keyword "jings" 
// https://geoapi.qweather.com/v2/poi/lookup?type=scenic&location=jings&lang=en&key=YOUR_KEY

{
  "code": "200",
  "poi": [
    {
      "name": "Jingshan Park",
      "id": "10101010012A",
      "lat": "39.91999",
      "lon": "116.38999",
      "adm2": "Beijing",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "67",
      "fxLink": "http://hfx.link/1"
    },
    {
      "name": "Jingsi Garden",
      "id": "10119040702A",
      "lat": "31.15999",
      "lon": "120.68000",
      "adm2": "Suzhou",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "86",
      "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