城市搜索

平台: API iOS Android

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

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

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

接口代码 接口 数据类
geoCityLookup 城市查询 GeoCityLookupResponse

参数

GeoCityLookupParameter

  • location(必选)需要查询地区的名称,支持文字、以英文逗号分隔的经度,纬度坐标(十进制,最多支持小数点后两位)、LocationIDAdcode(仅限中国城市)。例如 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 数据许可或版权声明,可能为空