城市搜索，可获取到该城市的基本信息，包括城市的Location ID（你需要这个ID去查询天气），多语言名称、经纬度、时区、海拔、Rank值、归属上级行政区域、所在行政区域等。 另外，城市搜索也可以帮助你在你的APP中实现模糊搜索，用户只需要输入1-2个字即可获得结果。
| 接口代码 |
接口说明 |
数据类 |
| getGeoCityLookup |
城市查询 |
GeoBean |
接口参数说明
-
location(必选)需要查询地区的名称，支持文字、以英文逗号分隔的经度,纬度坐标（十进制，最多支持小数点后两位）、LocationID或Adcode（仅限中国城市）。例如 location=北京 或 location=116.41,39.92
-
adm城市的上级行政区划，可设定只在某个行政区划范围内进行搜索，用于排除重名城市或对结果进行过滤。例如 adm=beijing
-
range搜索范围，可设定只在某个国家或地区范围内进行搜索，国家和地区名称需使用ISO 3166 所定义的国家代码。如果不设置此参数，搜索范围将在所有城市。例如 range=cn
-
number返回结果的数量，取值范围1-20，默认返回10个结果。
-
lang多语言设置，请阅读多语言文档，了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。
示例代码
QWeather.getGeoCityLookup(Context context, String location, String adm, Range range, int number, Lang lang, final QWeather.OnResultGeoListener listener);
QWeather.getGeoCityLookup(Context context, String location, Range range, int number, Lang lang, final QWeather.OnResultGeoListener listener);
QWeather.getGeoCityLookup(Context context, String location, int number, Lang lang, final QWeather.OnResultGeoBeansListener listener);
QWeather.getGeoCityLookup(Context context, String location, final QWeather.OnResultGeoBeansListener listener);
GeoBean属性
| 属性 |
说明 |
示例值 |
| getCode |
参考状态码 |
200 |
| getLocationBean |
城市数据 |
List<LocationBean> |
Refer
| 属性 |
说明 |
示例值 |
| getSourcesList |
原始数据来源 |
QWeather |
| getLicenseList |
使用许可 |
QWeather Developers License |
LocationBean 基础信息
| 属性 |
说明 |
示例值 |
| getName |
地区／城市名称 |
卓资 |
| getId |
地区／城市ID |
101080402 |
| getLon |
地区／城市经度 |
112.577702 |
| getLat |
地区／城市纬度 |
40.89576 |
| getAdm2 |
该地区／城市的上级城市 |
乌兰察布 |
| getAdm1 |
该地区／城市所属行政区域 |
内蒙古 |
| getCountry |
该地区／城市所属国家名称 |
中国 |
| getTz |
该地区／城市所在时区 |
Asia/Shanghai |
| getUtcOffset |
该地区/城市目前与UTC时间偏移的小时数 |
+08:00 |
| getIsDst |
该地区/城市是否当前处于夏令时,1: 表示当前处于夏令时, 0: 表示当前不是夏令时 |
0 |
| getType |
该地区／城市的属性 |
city |
| getRank |
该地区／城市评分 |
10 |
| getFxLink |
城市的天气预报网页链接 |
https://www.qweather.com/weather/zhuozi-101080402.html |