热门城市查询

平台: API iOS Android

获取全球各国热门城市列表。

请求URL

https://geoapi.qweather.com/v2/city/top?[请求参数]

请求参数

请求参数包括必选和可选参数,如不填写可选参数将使用其默认值,参数之间使用 &进行分隔。

  • key(必选)用户认证key,请参考如何获取你的KEY。支持数字签名方式进行认证。例如 key=123456789ABC
  • range搜索范围,可设定只在某个国家或地区范围内进行搜索,国家和地区名称需使用ISO 3166 所定义的国家代码。如果不设置此参数,搜索范围将在所有城市。例如 range=cn
  • number返回结果的数量,取值范围1-20,默认返回10个结果。
  • lang多语言设置,更多语言可选值参考语言代码。当数据不匹配你设置的语言时,将返回英文或其本地语言结果。

请求示例

中国热门城市前5位

curl -L -X GET --compressed 'https://geoapi.qweather.com/v2/city/top?number=5&range=cn&key=YOUR_KEY'

返回数据

返回数据是JSON格式并进行了Gzip压缩,数据类型均为字符串。

{
  "code": "200",
  "topCityList": [
    {
      "name": "余杭",
      "id": "101210106",
      "lat": "30.42118",
      "lon": "120.30173",
      "adm2": "杭州",
      "adm1": "浙江省",
      "country": "中国",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "25",
      "fxLink": "http://hfx.link/32t1"
    },
    {
      "name": "嘉定",
      "id": "101020500",
      "lat": "31.38352",
      "lon": "121.25033",
      "adm2": "上海",
      "adm1": "上海市",
      "country": "中国",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "23",
      "fxLink": "http://hfx.link/2bf1"
    },
    {
      "name": "朝阳",
      "id": "101010300",
      "lat": "39.92148",
      "lon": "116.48641",
      "adm2": "北京",
      "adm1": "北京市",
      "country": "中国",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "15",
      "fxLink": "http://hfx.link/2az1"
    },
    {
      "name": "萧山",
      "id": "101210102",
      "lat": "30.16293",
      "lon": "120.27069",
      "adm2": "杭州",
      "adm1": "浙江省",
      "country": "中国",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "23",
      "fxLink": "http://hfx.link/32p1"
    },
    {
      "name": "江干",
      "id": "101210111",
      "lat": "30.26660",
      "lon": "120.20263",
      "adm2": "杭州",
      "adm1": "浙江省",
      "country": "中国",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "25",
      "fxLink": "http://hfx.link/1tvn1"
    }
  ],
  "refer": {
    "sources": [
      "qweather.com"
    ],
    "license": [
      "commercial license"
    ]
  }
}
  • code API状态码,具体含义请参考状态码
  • topCityList.name 地区/城市名称
  • topCityList.id 地区/城市ID
  • topCityList.lat 地区/城市纬度
  • topCityList.lon 地区/城市经度
  • topCityList.adm2 地区/城市的上级行政区划名称
  • topCityList.adm1 地区/城市所属一级行政区域
  • topCityList.country 地区/城市所属国家名称
  • topCityList.tz 地区/城市所在时区
  • topCityList.utcOffset 地区/城市目前与UTC时间偏移的小时数,参考详细说明
  • topCityList.isDst 地区/城市是否当前处于夏令时1 表示当前处于夏令时,0 表示当前不是夏令时。
  • topCityList.type 地区/城市的属性
  • topCityList.rank 地区评分
  • topCityList.fxLink 该地区的天气预报网页链接,便于嵌入你的网站或应用
  • refer.sources 原始数据来源,或数据源说明,可能为空
  • refer.license 数据许可或版权声明,可能为空