POI搜索

平台: API iOS Android

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

请求URL

https://geoapi.qweather.com/v2/poi/lookup?{查询参数}

请求参数

请求参数包括必选和可选参数，参数之间使用&进行分隔。

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

请求示例

搜索关键字jings

curl -L -X GET --compressed 'https://geoapi.qweather.com/v2/poi/lookup?type=scenic&location=jings&key=YOUR_KEY'

返回数据

返回数据是JSON格式并进行了Gzip压缩。

{
  "code": "200",
  "poi": [
    {
      "name": "景山公园",
      "id": "10101010012A",
      "lat": "39.91999",
      "lon": "116.38999",
      "adm2": "北京",
      "adm1": "北京",
      "country": "中国",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "67",
      "fxLink": "https://www.qweather.com"
    },
    {
      "name": "静思园",
      "id": "10119040702A",
      "lat": "31.15999",
      "lon": "120.68000",
      "adm2": "苏州",
      "adm1": "苏州",
      "country": "中国",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "scenic",
      "rank": "86",
      "fxLink": "https://www.qweather.com"
    }
  ],
  "refer": {
    "sources": [
      "QWeather"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

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 数据许可或版权声明，可能为空