City Lookup

City Lookup provides reverse geocoding, geolocation lookup services, supports multi-language, fuzzy search and other functions.

With the City Lookup, you can get the basic information of the city, including the Location ID of the city (you need this ID to get the weather), multilingual name, latitude and longitude, time zone, altitude, rank, administrative, etc.

In addition, GeoAPI - City Lookup can also help you to implement fuzzy search in your APP, users only need to type 1 or 2 words to get results.

Endpoint#

GET /geo/v2/city/lookup

Parameters#

Query parameters

  • location (required) The location to be queried, support LocationID or comma-separated longitude and latitude (decimal, up to 2 decimal places), LocationID can be obtained by GeoAPI. Example: location=101010100 or location=116.41,39.92
  • adm Superior administrative divisions of a city, useful for excluding cities with similar names or for filtering results. Example adm = beijing
  • range Set to search only within a certain country or region. The country and region name needs to use country code ISO 3166. If this parameter is not set, the search range will be all cities. Example: range=cn
  • 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#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/geo/v2/city/lookup?location=116.41%2C39.92&adm=beijing&range=cn&number=10&lang=en'

Replace your_token and your_api_host with your JWT Authentication and API Host

Try it

Response#

{
  "code": "200",
  "location": [
    {
      "name": "Dongcheng",
      "id": "101011600",
      "lat": "39.91755",
      "lon": "116.41876",
      "adm2": "Beijing",
      "adm1": "Beijing",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "35",
      "fxLink": "https://www.qweather.com/weather/dongcheng-101011600.html"
    }
  ],
  "refer": {
    "sources": [
      "https://developer.qweather.com/attribution.html"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}
  • code string Status code
  • location array Location information 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 Is the location currently on daylight saving time. 1 for daylight saving time and 0 for not in daylight saving time
    • 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