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

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

  string

  Superior administrative divisions of a city, useful for excluding cities with similar names or for filtering results. Example adm = beijing
• range

  string

  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

  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/city/lookup?location=116.41%2C39.92'

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

    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