POI范围搜索

平台: API iOS Android

提供指定区域范围内查询所有POI信息。

接口代码	接口	数据类
geoPoiRange	POI范围搜索	GeoPoiResponse

参数

GeoPoiRangeParameter

location(必选)需要查询地区的以英文逗号分隔的经度,纬度坐标（十进制，最多支持小数点后两位）。例如 location=116.41,39.92
type(必选)POI类型，可选择搜索某一类型的POI。
- scenic 景点
- CSTA 潮流站点
- TSTA 潮汐站点
radius搜索范围，可设置搜索半径，取值范围1-50，单位：公里。默认5公里。
number返回结果的数量，取值范围1-20，默认返回10个结果。
lang多语言设置，请阅读多语言文档，了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。

示例代码

Swift

Task{
    do{
        let response = try await QWeather.instance
                    .geoPoiRange(.init(location: "113.88,22.45", type: .CSTA, radius: 50))
        print(response)
    } catch QWeatherError.errorResponse(let error) {
        print(error)
    } catch {
        print(error)
    }
}

Objective-C

GeoPoiRangeParameter * parameter = [GeoPoiRangeParameter instanceWithLocation:@"116.41,39.92"
                                                                            type:PoiSCENIC
                                                                        radius:@(50)
                                                                        number:@(10)
                                                                            lang:@(LangZH_HANS)];
[QWeatherObjc geoPoiRange: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 数据许可或版权声明，可能为空