POI Lookup

Endpoint#

GET /geo/v2/poi/lookup

Parameters#

Query parameters

• location ^required

  string

  The location to be queried, support location name, LocationID or comma-separated longitude and latitude (decimal, up to 2 decimal places), LocationID can be obtained by GeoAPI. Example: location=beijing or location=101010100 or 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
• city

  string

  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

  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/lookup?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"
    }
  ],
  "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