POI Lookup
POI Lookup API provides basic information of POI(scenic spot, tide stations, currents stations, etc.)
Request URL
https://geoapi.qweather.com/v2/poi/lookup?{QueryParams}
Request Parameters
All parameters are separated by &
. If no optional parameters are set, the default value will be used.
-
location
(required)The location to be queried, support text, LocationID, comma-separated longitude and latitude (decimal, up to 2 decimal places), Adcode(Chinese cities only). For example:location=beijing
orlocation=116.41,39.92
-
type
(required)Choose to search for a certain type of POI.scenic
Scenic SpotCSTA
Currents StationTSTA
Tide Station
-
key
(required)API authentication key, please refer to How To Get Your Key. Support Signature Authentication. 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, please see Language to find out how our multi-language works and how to set up.
Request Example
Response
The response is in JSON format and is Gzip compressed.
{
"code": "200",
"poi": [
{
"name": "景山公园",
"id": "10101010012A",
"lat": "39.91999",
"lon": "116.38999",
"adm2": "北京",
"adm1": "北京",
"country": "中国",
"tz": "Asia/Shanghai",
"utcOffset": "+08:00",
"isDst": "0",
"type": "scenic",
"rank": "67",
"fxLink": "https://www.qweather.com"
},
{
"name": "静思园",
"id": "10119040702A",
"lat": "31.15999",
"lon": "120.68000",
"adm2": "苏州",
"adm1": "苏州",
"country": "中国",
"tz": "Asia/Shanghai",
"utcOffset": "+08:00",
"isDst": "0",
"type": "scenic",
"rank": "86",
"fxLink": "https://www.qweather.com"
}
],
"refer": {
"sources": [
"QWeather"
],
"license": [
"QWeather Developers License"
]
}
}
-
code
See 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 and0
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