编辑

POI搜索

平台: API iOS Android

使用关键字和坐标查询POI信息（景点、火车站、飞机场、港口等）

接口代码 接口 数据类
geoPoiLookup POI搜索 GeoPoiResponse

参数

GeoPoiLookupParameter

  • location(必选)需要查询地区的名称，支持文字、以英文逗号分隔的经度,纬度坐标（十进制，最多支持小数点后两位）、LocationID或Adcode（仅限中国城市）。例如 location=北京 或 location=116.41,39.92
  • type(必选)POI类型，可选择搜索某一类型的POI。
    • scenic 景点
    • CSTA 潮流站点
    • TSTA 潮汐站点
  • city选择POI所在城市，可设定只搜索在特定城市内的POI信息。城市名称可以是文字或城市的LocationID。默认不限制特定城市。
    城市名称为精准匹配，建议使用LocaitonID，如文字无法匹配，则数据返回为空。
  • number返回结果的数量，取值范围1-20，默认返回10个结果。
  • lang多语言设置，请阅读多语言文档，了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。

示例代码

Swift

Task{
    do {
        let parameter = GeoPoiLookupParameter(location: "116.41,39.92", type: .SCENIC)
        let response = try await QWeather.instance
            .geoPoiLookup(parameter)
    } catch QWeatherError.errorResponse(let error) {
        print(error)
    } catch {
        print(error)
    }
}

Objective-C

GeoPoiLookupParameter *parameter = [GeoPoiLookupParameter instanceWithLocation:@"116.41,39.92" 
                                            type:PoiSCENIC 
                                            city:nil 
                                            number:@(10) 
                                            lang:@(LangZH_HANS)];
[QWeatherObjc geoPoiLookup: parameter completionHandler:^(GeoPoiResponse * _Nullable response, NSError * _Nullable error) {
    if (response) {
        NSLog(@"%@", response.description);
    }
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    }
}];

返回数据

GeoPoiResponse

  • code 请参考状态码
  • poi.name POI（兴趣点）名称
  • poi.id POI（兴趣点）ID
  • poi.lat POI（兴趣点）纬度
  • poi.lon POI（兴趣点）经度
  • poi.adm2 POI（兴趣点）的上级行政区划名称
  • poi.adm1 POI（兴趣点）所属一级行政区域
  • poi.country POI（兴趣点）所属国家名称
  • poi.tz POI（兴趣点）所在时区
  • poi.utcOffset POI（兴趣点）目前与UTC时间偏移的小时数，参考详细说明
  • poi.isDst POI（兴趣点）是否当前处于夏令时。1 表示当前处于夏令时，0 表示当前不是夏令时
  • poi.type POI（兴趣点）的属性
  • poi.rank 地区评分
  • poi.fxLink 该地区的天气预报网页链接，便于嵌入你的网站或应用
  • refer.sources 原始数据来源，或数据源说明，可能为空
  • refer.license 数据许可或版权声明，可能为空