城市搜索
城市搜索提供全球地理位位置、全球城市搜索服务,支持经纬度坐标反查、多语言、模糊搜索等功能。
天气数据是基于地理位置的数据,因此获取天气之前需要先知道具体的位置信息。使用城市搜索,可获取到该城市的基本信息,包括城市的Location ID(你需要这个ID去查询天气),多语言名称、经纬度、时区、海拔、Rank值、归属上级行政区域、所在行政区域等。
另外,城市搜索也可以帮助你在你的APP中实现模糊搜索,用户只需要输入1-2个字即可获得结果。
接口代码 | 接口 | 数据类 |
---|---|---|
geoCityLookup | 城市查询 | GeoCityLookupResponse |
参数
GeoCityLookupParameter
-
location
(必选)需要查询地区的名称,支持文字、以英文逗号分隔的经度,纬度坐标(十进制,最多支持小数点后两位)、LocationID或Adcode(仅限中国城市)。例如location=北京
或location=116.41,39.92
-
adm
城市的上级行政区划,可设定只在某个行政区划范围内进行搜索,用于排除重名城市或对结果进行过滤。例如adm=beijing
-
range
搜索范围,可设定只在某个国家或地区范围内进行搜索,国家和地区名称需使用ISO 3166 所定义的国家代码。如果不设置此参数,搜索范围将在所有城市。例如range=cn
-
number
返回结果的数量,取值范围1-20,默认返回10个结果。 -
lang
多语言设置,请阅读多语言文档,了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。
示例代码
public void geoCityLookup(GeoCityLookupParameter parameter, Callback<GeoCityLookupResponse> callback);
返回数据
GeoCityLookupResponse
-
code
请参考状态码 -
location.name
地区/城市名称 -
location.id
地区/城市ID -
location.lat
地区/城市纬度 -
location.lon
地区/城市经度 -
location.adm2
地区/城市的上级行政区划名称 -
location.adm1
地区/城市所属一级行政区域 -
location.country
地区/城市所属国家名称 -
location.tz
地区/城市所在时区 -
location.utcOffset
地区/城市目前与UTC时间偏移的小时数,参考详细说明 -
location.isDst
地区/城市是否当前处于夏令时。1
表示当前处于夏令时,0
表示当前不是夏令时。 -
location.type
地区/城市的属性 -
location.rank
地区评分 -
location.fxLink
该地区的天气预报网页链接,便于嵌入你的网站或应用 -
refer.sources
原始数据来源,或数据源说明,可能为空 -
refer.license
数据许可或版权声明,可能为空