热门城市查询

获取全球各个国家国家热门城市列表，通过该列表可以让用户轻松查看各国主要城市的天气状况

GeoAPI每天每个账号下所有应用前50000次免费，超出部分参考计费方式

请求URL #

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

请求参数 #

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

key

用户认证key，请参考如何获取你的KEY。支持数字签名方式进行认证。例如 key=123456789ABC

range

搜索范围，可设定只在某个国家范围内进行搜索，国家名称需使用ISO 3166 所定义的国家代码。

world 全球城市范围，默认
cn 中国城市范围，可替换为其他国家的ISO 3166 国家代码，例如range=us
us 美国
fr 法国
uk 英国
ru 俄罗斯
更多国家代码

number

返回结果的数量，取值范围1-20，默认返回10个结果

lang

多语言设置，默认中文，当数据不匹配你设置的语言时，将返回英文或其本地语言结果。

zh 中文, 默认
en 英语
fr 法语
es 西班牙语
ja 日语
ko 韩语
查看更多语言代码

返回数据 #

// 中国热门城市前5位 
// https://geoapi.qweather.com/v2/city/top?number=5&range=cn&key=你的KEY

{
  "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`	数据许可或版权声明，可能为空