热门城市查询
获取全球各个国家国家热门城市列表，通过该列表可以让用户轻松查看各国主要城市的天气状况。
| 接口代码（枚举） | 接口 | 数据类 |
|---|---|---|
| INQUIRE_TYPE_GEO_TOPCITY | 热门城市查询 | GeoBaseClass |
请求参数
请求参数包括必选和可选参数，如不填写可选参数将使用其默认值。
-
appKey(必选)用户认证key，请参考如何获取你的KEY。例如appKey=123456789ABC -
lang多语言设置，请阅读多语言文档，了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。 -
range搜索范围，可设定只在某个国家或地区范围内进行搜索，国家和地区名称需使用ISO 3166 所定义的国家代码。如果不设置此参数，搜索范围将在所有城市。例如range=cn -
number返回结果的数量，取值范围1-20，默认返回10个结果。
示例代码
QWeatherConfigInstance.publicID = @"publicID";
QWeatherConfigInstance.appKey = @"key";
QWeatherConfigInstance.appType = APP_TYPE_BIZ;
QWeatherConfigInstance.location = @"beijing";
[QWeatherConfigInstance weatherWithInquireType:INQUIRE_TYPE_GEO_TOPCITY WithSuccess:^(GeoBaseClass *responseObject) {
NSLog(@"描述->%@",[responseObject description]);
} faileureForError:^(NSError *error) {
NSLog(@"error->%@",error);
}];
返回数据
| 参数 | 描述 | 示例 |
|---|---|---|
| code | 状态码，具体含义请参考状态码 | 200 |
| location.name | 地区/城市名称 | 南山区 |
| location.cid | 地区/城市ID | 101280604 |
| location.lat | 地区/城市纬度 | 22.53122 |
| location.lon | 地区/城市经度 | 113.92942 |
| location.adm2 | 该地区/城市的上级行政区划名称 | 深圳市 |
| location.adm1 | 该地区/城市所属一级行政区域 | 广东省 |
| location.country | 该地区/城市所属国家名称 | 中国 |
| location.tz | 该地区/城市所在时区 | +0800 |
| location.utcOffset | 该地区/城市目前与UTC时间偏移的小时数，参考详细说明 | +08:00 |
| location.isDst | 该地区/城市是否当前处于夏令时 | 0 |
| location.type | 该地区/城市的属性 | city |
| location.rank | 地区评分 | 10 |
| location.fxLink | 该地区的天气预报网页链接，便于嵌入你的网站或应用 | http://hfx.link/34T5 |
| refer.sources | 原始数据来源，可能为空 | |
| refer.license | 使用许可，可能为空 |