POI搜索

平台: API iOS Android

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

接口代码(枚举) 接口 数据类
INQUIRE_TYPE_GEO_POI_LOOKUP POI搜索 GeoBaseClass

请求参数

请求参数包括必选和可选参数,如不填写可选参数将使用其默认值。

  • location(必选)需要查询地区的名称,支持文字、以英文逗号分隔的经度,纬度坐标(十进制,最多支持小数点后两位)、LocationIDAdcode(仅限中国城市)。例如 location=北京location=116.41,39.92
  • appKey(必选)用户认证key,请参考如何获取你的KEY。例如 appKey=123456789ABC
  • 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 使用许可,可能为空