编辑

热门城市查询

平台: API iOS Android

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

接口代码 接口 数据类
geoCityTop 热门城市查询 GeoCityTopResponse

参数

GeoCityTopParameter

  • range搜索范围，可设定只在某个国家或地区范围内进行搜索，国家和地区名称需使用ISO 3166 所定义的国家代码。如果不设置此参数，搜索范围将在所有城市。例如 range=cn
  • number返回结果的数量，取值范围1-20，默认返回10个结果。
  • lang多语言设置，请阅读多语言文档，了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。

示例代码

Swift

Task{
    do {
        let parameter = GeoCityTopParameter(range: Range.CN)
        let response = try await QWeather.instance
            .geoCityTop(parameter)
        print(response)
    } catch QWeatherError.errorResponse(let error) {
        print(error)
    } catch {
        print(error)
    }
}

Objective-C

GeoCityTopParameter *parameter = [GeoCityTopParameter instanceWithRange:@(RangeCN) 
                                        number:@(10) 
                                        lang:@(LangZH_HANS)];
[QWeatherObjc geoCityTop:parameter completionHandler:^(GeoCityTopResponse * _Nullable response, NSError * _Nullable error) {
    if (response) {
        NSLog(@"%@", response.description);
    }
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    }
}];

返回数据

GeoCityTopResponse

  • code 请参考状态码
  • 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 数据许可或版权声明，可能为空