cityLookup

suspend fun cityLookup(location: Location, adm: String? = null, range: QWSdk.CountryCode = QWSdk.CountryCode.CN, number: Int = 10, lang: QWSdk.Lang = QWSdk.Lang.ZH): Result<GeoLookup>(source)

城市搜索

城市搜索API提供全球地理位位置、全球城市搜索服务,支持经纬度坐标反查、多语言、模糊搜索等功能。

天气数据是基于地理位置的数据,因此获取天气之前需要先知道具体的位置信息。使用城市搜索,可获取 到该城市的基本信息,包括城市的Location ID(你需要这个ID去查询天气),多语言名称、经纬度、 时区、海拔、Rank值、归属上级行政区域、所在行政区域等。

另外,城市搜索也可以帮助你在你的APP中实现模糊搜索,用户只需要输入1-2个字即可获得结果。

Parameters

location

需要查询地区的名称,支持文字 Name 、以英文逗号分隔的经度,纬度坐标 CoordinateLocationIDAdcode(仅限中国城市) 。

adm

城市的上级行政区划,可设定只在某个行政区划范围内进行搜索,用于排除重名城市 或对结果进行过滤。例如 adm=beijing

range

搜索范围,可设定只在某个国家或地区范围内进行搜索,国家和地区名称需使用 ISO 3166 所定义的国家代码 。如果不设置此参数,搜索范围将在 所有城市。例如 range=cn 。

number

返回结果的数量,取值范围1-20,默认返回10个结果。

lang

多语言设置,请阅读 多语言 文档,了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。

Throws

number 未在 0-20 范围内会抛出该异常。