Edit

POI Lookup

Platform: API iOS Android

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

Endpoint 

/geo/v2/poi/lookup

Parameters

Query parameters

  • 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 or 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
  • citySearch 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.
  • numberNumber of the results in response, from 1 to 20, 10 is the default.
  • langMulti-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/lookup?type=scenic&location=jings'

Replace your_token and your_api_host with your JWT Authentication and API Host

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 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