City Lookup

City Lookup provides global geolocation and city search services, including reverse geocoding, multilingual results, and fuzzy search.

Weather data is location-based, so you need to identify a location before requesting weather data. City Lookup returns basic location information, including the Location ID, multilingual names, latitude and longitude, time zone, elevation, rank, and administrative divisions.

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