Geo

class Geo(val qwSdk: QWSdk)(source)

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

天气数据是基于地理位置的数据，因此获取天气之前需要先知道具体的位置信息。和风天气提供一个功能强大的位置信息搜索 API 服务： GeoAPI 。通过 GeoAPI ，你可获取到需要查询城市或 POI 的基本信息，包括查询地区的 Location ID（你需要这个 ID 去查询天气），多语言名称、经纬度、时区、海拔、Rank 值、归属上级行政区域、所在行政区域等。

除此之外，GeoAPI还可以帮助你：

避免重名城市的困扰
支持名称模糊搜索
在你的应用或网站中根据用户输入的名称返回多个城市结果，便于用户选择准确的城市并返回该城市天气
在你的应用或网站中展示热门城市
不需要维护城市列表，城市信息更新实时获取

Constructors

Geo

internal constructor(qwSdk: QWSdk)

Properties

qwSdk

private val qwSdk: QWSdk

Functions

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>

城市搜索

poiLookup

suspend fun poiLookup(location: Location, type: QWSdk.POIType, city: String? = null, number: Int = 10, lang: QWSdk.Lang = QWSdk.Lang.ZH): Result<GeoPoi>

POI搜索

poiRange

suspend fun poiRange(location: Coordinate, type: QWSdk.POIType, radius: Int = 5, number: Int = 10, lang: QWSdk.Lang = QWSdk.Lang.ZH): Result<GeoPoiRange>

POI范围搜索

topCity

suspend fun topCity(range: QWSdk.CountryCode = QWSdk.CountryCode.CN, number: Int = 10, lang: QWSdk.Lang = QWSdk.Lang.ZH): Result<GeoTop>

热门城市查询