POI搜索
使用关键字和坐标查询POI信息(景点、火车站、飞机场、港口等)
接口代码(枚举) | 接口 | 数据类 |
---|---|---|
INQUIRE_TYPE_GEO_POI_LOOKUP | POI搜索 | GeoBaseClass |
请求参数
请求参数包括必选和可选参数,如不填写可选参数将使用其默认值。
-
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
多语言设置,请阅读多语言文档,了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。
示例代码
QWeatherConfigInstance.publicID = @"publicID";
QWeatherConfigInstance.appKey = @"key";
QWeatherConfigInstance.appType = APP_TYPE_BIZ;
QWeatherConfigInstance.location = @"beijing";
[QWeatherConfigInstance weatherWithInquireType:INQUIRE_TYPE_GEO_POI_LOOKUP WithSuccess:^(GeoBaseClass *responseObject) {
NSLog(@"描述->%@",[responseObject description]);
} faileureForError:^(NSError *error) {
NSLog(@"error->%@",error);
}];
返回数据
参数 | 描述 | 示例 |
---|---|---|
code | 状态码,具体含义请参考状态码 | 200 |
location.name | 地区/城市名称 | 南山区 |
location.cid | 地区/城市ID | 101280604 |
location.lat | 地区/城市纬度 | 22.53122 |
location.lon | 地区/城市经度 | 113.92942 |
location.adm2 | 该地区/城市的上级行政区划名称 | 深圳市 |
location.adm1 | 该地区/城市所属一级行政区域 | 广东省 |
location.country | 该地区/城市所属国家名称 | 中国 |
location.tz | 该地区/城市所在时区 | +0800 |
location.utcOffset | 该地区/城市目前与UTC时间偏移的小时数,参考详细说明 | +08:00 |
location.isDst | 该地区/城市是否当前处于夏令时 | 0 |
location.type | 该地区/城市的属性 | city |
location.rank | 地区评分 | 10 |
location.fxLink | 该地区的天气预报网页链接,便于嵌入你的网站或应用 | http://hfx.link/34T5 |
refer.sources | 原始数据来源,可能为空 | |
refer.license | 使用许可,可能为空 |