热门城市查询
获取全球各个国家国家热门城市列表,通过该列表可以让用户轻松查看各国主要城市的天气状况
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 |
地区/城市是否当前处于夏令时 |
topCityList.type |
地区/城市的属性 |
topCityList.rank |
|
topCityList.fxLink |
该地区的天气预报网页链接,便于嵌入你的网站或应用 |
refer.sources |
原始数据来源,或数据源说明,可能为空 |
refer.license |
数据许可或版权声明,可能为空 |