AI 助理
备案控制台
文档
输入文档关键字查找
首页 信息查询服务 开发参考 周边查询 周边查询(高级)

周边查询(高级)

更新时间：
我的收藏

本文介绍通过阿里云OpenAPI SDK调用周边查询高级版接口的方法以及参数说明。

API概述

周边查询的自然语言接口，支持自然语言查询全量POI类型。

业务场景明确时，可通过场景参数限定查询范围，从而在准确度和 rt 上获得更好的效果，目前支持指定酒店、景点、餐厅、休闲娱乐这四类场景。当然也可忽略场景参数，交由模型智能识别。

API定义

接口名称

CommonQueryByScene

请求参数

参数名

含义及规则

是否必须

缺省值

query

搜索关键词

必填

无

querySceneEnumCode

搜索场景枚举：

hotels - 酒店场景

attractions - 景点场景

restaurants - 餐厅场景

entertainment - 休闲娱乐场景

非必填

无

响应参数

参数名

类型

说明

requestId

string

请求唯一ID

data

list

返回的地点数据列表

id

string

内部标识号

name

string

名称

latitude

string

位置的经度

longitude

string

位置的纬度

types

string

类型

typeCode

string

类型编码

provinceName

string

所属省份

provinceCode

string

所属省份编码

cityName

string

所属城市

cityCode

string

所属城市编码

districtName

string

所属区域

districtCode

string

所属区域编码

address

string

详细地址

distanceMeter

string

距中心点距离，单位米

metadata

object

相关商业信息

phone

string

联系电话

businessArea

string

所属商圈

mainTag

string

主标签

score

string

评分

dailyOpeningHours

string

今日营业时间

weeklyOpeningDays

string

每周营业时间

averageSpend

string

平均花费，单位元

images

list

图片列表

title

string

图片名称

url

string

图片链接

示例

请求示例

{
    "query":"杭州灵隐寺附近5km的高档酒店",
    "querySceneEnumCode":"hotels"
}

响应示例

{
  "requestId": "15A85F99-408F-5BFA-B617-0C7D3E732ABD",
  "data": [
    {
      "id": "B023B0BI3J",
      "name": "杭州法云安缦酒店",
      "latitude": "30.234403",
      "longitude": "120.097327",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "815",
      "address": "西湖景区法云弄22号",
      "metadata": {
        "phone": "0571-8732****",
        "businessArea": "西湖旅游区中心片区",
        "mainTag": "豪华型",
        "score": "4.7",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/6ca3129317745e14b893e731408c9610"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/083b8318d55c09256d38a21940f87af2"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/0d56912b30beb84176c2c898e68a9c75"
        }
      ]
    },
    {
      "id": "B023B03721",
      "name": "杭州九里云松度假酒店",
      "latitude": "30.244454",
      "longitude": "120.113209",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "1204",
      "address": "灵隐路18-8号",
      "metadata": {
        "phone": "0571-8798****|0571-8799****|0571-8898****",
        "businessArea": "西湖",
        "mainTag": "豪华型",
        "score": "4.8",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/e1c1705c58ce9e61c1e61421188da16d"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/5b727b0573ac9fa21eb833971db8a600"
        },
        {
          "title": "大厅",
          "url": "http://store.is.autonavi.com/showpic/e76beb3bedca3fe0375cef12742ea23e"
        }
      ]
    },
    {
      "id": "B023B09QFZ",
      "name": "杭州雷迪森龙井庄园",
      "latitude": "30.228845",
      "longitude": "120.114077",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "1806",
      "address": "里鸡笼山86号",
      "metadata": {
        "phone": "0571-5655****|0571-8691****|1377755****",
        "businessArea": "龙井",
        "mainTag": "豪华型",
        "score": "4.4",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": "Logo",
          "url": "http://store.is.autonavi.com/showpic/ba0257fbb9a93700efdce6d8f4f59401"
        },
        {
          "title": "池畔·高级双床房",
          "url": "http://store.is.autonavi.com/showpic/706c1036280856d41d5a717f87c1d740"
        },
        {
          "title": "单卧复式套房",
          "url": "http://store.is.autonavi.com/showpic/0628fd2799802e299889b2cd806eeb52"
        }
      ]
    },
    {
      "id": "B023B157YK",
      "name": "杭州法云安缦酒店安缦馆",
      "latitude": "30.235544",
      "longitude": "120.097306",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "708",
      "address": "西湖景区法云弄22号",
      "metadata": {
        "phone": "0571-8732****",
        "businessArea": "西湖旅游区中心片区",
        "mainTag": "住宿服务,宾馆酒店,五星级宾馆",
        "score": null,
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": null,
          "url": "https://aos-comment.amap.com/B023B157YK/headerImg/f4b78292a87486446ac723c715c10177_2048_2048_80.jpg"
        },
        {
          "title": null,
          "url": "https://aos-comment.amap.com/B023B157YK/headerImg/4174d44cb22acab9c2c98221b2735ec2_2048_2048_80.jpg"
        },
        {
          "title": null,
          "url": "https://comment-oss-online.oss-cn-wulanchabu.aliyuncs.com/B023B157YK/comment/F5FDB171_386E_4519_B6B7_F8CDA745AFBE_L0_001_IMG_4132.JPG"
        }
      ]
    },
    {
      "id": "B023B08U8P",
      "name": "浙江世贸君澜大饭店",
      "latitude": "30.266359",
      "longitude": "120.140608",
      "types": "住宿服务|宾馆酒店|五星级宾馆|餐饮服务|餐饮相关场所|餐饮相关",
      "typeCode": "100102|050000",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "4721",
      "address": "曙光路122号",
      "metadata": {
        "phone": "0571-8799****|1875816****",
        "businessArea": "北山",
        "mainTag": "五星级酒店",
        "score": "4.7",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": "西餐厅",
          "url": "http://store.is.autonavi.com/showpic/b915aba6a703ee13c74533a82b6f793c"
        },
        {
          "title": "客房",
          "url": "http://store.is.autonavi.com/showpic/437c3ea388a894ae5be132127937ad18"
        },
        {
          "title": "客房",
          "url": "http://store.is.autonavi.com/showpic/039cc7c6f770299da4b6b7de0012db04"
        }
      ]
    },
    {
      "id": "B023B0BCMM",
      "name": "杭州西子湖四季酒店",
      "latitude": "30.251363",
      "longitude": "120.128537",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "2860",
      "address": "灵隐路5号",
      "metadata": {
        "phone": "0571-8829****",
        "businessArea": "西湖",
        "mainTag": "西餐",
        "score": "4.7",
        "dailyOpeningHours": "07:00-22:00",
        "weeklyOpeningDays": "周一至周日 07:00-22:00",
        "averageSpend": null
      },
      "images": [
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/b147d32655510d419dfea917ac651968"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/b52d378c3cd0d74e608b2c51961c2529"
        },
        {
          "title": "客房",
          "url": "http://store.is.autonavi.com/showpic/91754378a4650ace57f591646c2d360e"
        }
      ]
    },
    {
      "id": "B0FFFPZE3J",
      "name": "西溪谷君亭酒店",
      "latitude": "30.264442",
      "longitude": "120.106033",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "2666",
      "address": "西溪路535号",
      "metadata": {
        "phone": "0571-8715****",
        "businessArea": "西湖",
        "mainTag": "豪华型",
        "score": "4.6",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": "Logo",
          "url": "http://store.is.autonavi.com/showpic/a20db49eb63fd6e196aad76cede1817e"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/b05fe59c9afd75d80f7c18cb4a0def09"
        },
        {
          "title": "豪华大床房",
          "url": "http://store.is.autonavi.com/showpic/c1ba206c13dca29f0cb7393b170e394a"
        }
      ]
    },
    {
      "id": "B0FFG8VE36",
      "name": "西湖山庄",
      "latitude": "30.256428",
      "longitude": "120.142041",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "4276",
      "address": "北山街84号",
      "metadata": {
        "phone": "0571-5808****",
        "businessArea": "西湖旅游区中心片区",
        "mainTag": "豪华型",
        "score": "4.8",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/ae69f1f2573d0a90cb685a17cd99f3eb"
        },
        {
          "title": "专享双床房",
          "url": "http://store.is.autonavi.com/showpic/a59cd4e02f3e4b83a2d1e1e31824b72d"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/fad3732031fa7bbcba7f0bff1b369677"
        }
      ]
    },
    {
      "id": "B023B02167",
      "name": "浙江西子宾馆",
      "latitude": "30.232386",
      "longitude": "120.149789",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "4747",
      "address": "南山路37号",
      "metadata": {
        "phone": "0571-8702****",
        "businessArea": "西湖",
        "mainTag": "高档型",
        "score": "4.8",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/c874be41bab7fb3c52fb9d79065d815e"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/056f45f363de39f20b0e61d3345d17c4"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/5c90d5aebd0a97576f5cdfc9806fb152"
        }
      ]
    },
    {
      "id": "B023B0A4Z0",
      "name": "杭州西溪悦榕庄酒店",
      "latitude": "30.267148",
      "longitude": "120.086956",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "3242",
      "address": "紫金港路21号西溪天堂国际旅游综合体2号",
      "metadata": {
        "phone": "0571-8586****",
        "businessArea": "西溪",
        "mainTag": "豪华型",
        "score": "4.6",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/efd67f7f0038d30cfe08f230e82d45bf"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/94558b37aa02647aa13ac6fdc246fe4a"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/dc53c2860b7968672e63fc3198f39cfe"
        }
      ]
    },
    {
      "id": "B023B02BLI",
      "name": "中国杭州黄龙饭店",
      "latitude": "30.267140",
      "longitude": "120.142820",
      "types": "住宿服务|宾馆酒店|五星级宾馆|餐饮服务|餐饮相关场所|餐饮相关",
      "typeCode": "100102|050000",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "4943",
      "address": "曙光路120号(黄龙洞地铁站A2口步行90米)",
      "metadata": {
        "phone": "0571-8799****",
        "businessArea": "北山",
        "mainTag": "五星级酒店",
        "score": "4.7",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": "酒店外景",
          "url": "http://store.is.autonavi.com/showpic/e07eaa8d82c2a745125dee1af1fb79d2"
        },
        {
          "title": "Logo",
          "url": "http://store.is.autonavi.com/showpic/149300987639746fd46f64f8b688645c"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/6092beae85931ef344ea31d6d79759cf"
        }
      ]
    },
    {
      "id": "B023B1450V",
      "name": "西溪天堂西轩酒店",
      "latitude": "30.265201",
      "longitude": "120.087595",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "3021",
      "address": "紫金港路西溪天堂国际旅游综合体9号",
      "metadata": {
        "phone": "0571-8500****",
        "businessArea": "西溪",
        "mainTag": "豪华型",
        "score": "4.7",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": "Logo",
          "url": "http://store.is.autonavi.com/showpic/022fbfff286d56b46da61b13c2945962"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/5e0e7d3c5c2f55890836794eba4d0106"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/5a351411d18841e6bff3ccdb16629deb"
        }
      ]
    },
    {
      "id": "B023B0I01E",
      "name": "杭州西溪喜来登度假大酒店",
      "latitude": "30.267714",
      "longitude": "120.088728",
      "types": "住宿服务|宾馆酒店|五星级宾馆|餐饮服务|餐饮相关场所|餐饮相关",
      "typeCode": "100102|050000",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "3231",
      "address": "紫金港路西溪天堂国际旅游综合体1号",
      "metadata": {
        "phone": "0571-8500****",
        "businessArea": "西溪",
        "mainTag": "五星级酒店",
        "score": "4.7",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/946fe51850228ee86991a67f81a97581"
        },
        {
          "title": "商务",
          "url": "http://store.is.autonavi.com/showpic/28116e7a789b0561a4675fdf20cc2cc0"
        },
        {
          "title": "客房",
          "url": "http://store.is.autonavi.com/showpic/ccdb0b13787e98de08f3f140ba329ef0"
        }
      ]
    },
    {
      "id": "B023B1681T",
      "name": "杭州西溪合悦度假酒店",
      "latitude": "30.249346",
      "longitude": "120.061499",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "3953",
      "address": "留下镇百家园路128号",
      "metadata": {
        "phone": "0571-5607****|0571-5633****|0571-8522****",
        "businessArea": "西溪",
        "mainTag": "高档型",
        "score": "4.3",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": "Logo",
          "url": "http://store.is.autonavi.com/showpic/701b4445dd3ed0835c724f51eaf6aa9f"
        },
        {
          "title": "Logo",
          "url": "http://store.is.autonavi.com/showpic/cc7e01aa71028d8033205c80b9110dcc"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/64af7a4a6487bfbfa56db18a03501ab8"
        }
      ]
    },
    {
      "id": "B0FFGH3N2Q",
      "name": "心隅酒店",
      "latitude": "30.268634",
      "longitude": "120.111775",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "3252",
      "address": "西溪路546号",
      "metadata": {
        "phone": "0571-8768****|0571-8775****",
        "businessArea": "西湖",
        "mainTag": "豪华型",
        "score": "4.8",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": "Logo",
          "url": "http://store.is.autonavi.com/showpic/51a6f151e51999e2e09d55626029141e"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/555223c70b5b3bc979665d168b50f47c"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/9bef2af3ed018cfd94c2529b7c0ca9fc"
        }
      ]
    },
    {
      "id": "B023B01844",
      "name": "杭州花家山庄",
      "latitude": "30.223908",
      "longitude": "120.132272",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "3515",
      "address": "三台山路25号(近花港观鱼)",
      "metadata": {
        "phone": "0571-8797****|0571-8797****",
        "businessArea": "西湖",
        "mainTag": "豪华型",
        "score": "4.9",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/84ce4c4d79d54902fbeb72b818258d90"
        },
        {
          "title": "景观家庭套房",
          "url": "http://store.is.autonavi.com/showpic/e92dfe9d293743b3c87e73ba518237a4"
        },
        {
          "title": "景观行政房-大床",
          "url": "http://store.is.autonavi.com/showpic/dd11712410ddbbd7a12c4711a5fecbcd"
        }
      ]
    },
    {
      "id": "B023B01F50",
      "name": "杭州香格里拉饭店",
      "latitude": "30.253052",
      "longitude": "120.137602",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "3737",
      "address": "北山路78号",
      "metadata": {
        "phone": "0571-8797****",
        "businessArea": "北山",
        "mainTag": "豪华型",
        "score": "4.6",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/211101a2f1cacdea19b7e0b4635baf04"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/d3d12a7816bf7ee34cc654327b6ed7ec"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/7a6f0afd877657bbfcd5e726c566d038"
        }
      ]
    },
    {
      "id": "B0FFG2LZQL",
      "name": "杭州西轩酒店大厅",
      "latitude": "30.265327",
      "longitude": "120.087599",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "3033",
      "address": "紫金港路21号西溪天堂国际旅游综合体9号杭州西轩酒店1层",
      "metadata": {
        "phone": "0571-8500****",
        "businessArea": "西溪",
        "mainTag": "住宿服务,宾馆酒店,五星级宾馆",
        "score": null,
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": null,
          "url": "https://aos-comment.amap.com/B0FFG2LZQL/comment/0297c32520f99e6b6642f176648dadfd_2048_2048_80.jpg"
        },
        {
          "title": null,
          "url": "https://aos-comment.amap.com/B0FFG2LZQL/comment/b97c9466274d75d855081b65306c82c6_2048_2048_80.jpg"
        },
        {
          "title": null,
          "url": "https://aos-comment.amap.com/B0FFG2LZQL/comment/c2869512b1de77833f3451f029807646_2048_2048_80.jpg"
        }
      ]
    },
    {
      "id": "B0H3RMFKS0",
      "name": "杭州香格里拉饭店大堂",
      "latitude": "30.252575",
      "longitude": "120.136917",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "3656",
      "address": "北山路78号杭州香格里拉饭店",
      "metadata": {
        "phone": null,
        "businessArea": "北山",
        "mainTag": "住宿服务,宾馆酒店,五星级宾馆",
        "score": null,
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/be5793355c1ff8db9386c3d11621f647"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/f3083ebd1e29cdac40146759280c7283"
        },
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/3233ba03e19d68e81592fd41be1b1057"
        }
      ]
    },
    {
      "id": "B0H3AXD1MH",
      "name": "中国杭州黄龙饭店-南大堂",
      "latitude": "30.266611",
      "longitude": "120.143127",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "4932",
      "address": "曙光路与宝石山绿道2号线交叉口西120米",
      "metadata": {
        "phone": null,
        "businessArea": "北山",
        "mainTag": "住宿服务,宾馆酒店,五星级宾馆",
        "score": null,
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": [
        {
          "title": null,
          "url": "http://store.is.autonavi.com/showpic/6c03b633c5696c3fb2702f2f7a158976"
        }
      ]
    },
    {
      "id": "B0H377BRRJ",
      "name": "杭州西溪悦榕庄酒店大堂",
      "latitude": "30.267270",
      "longitude": "120.087065",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "3250",
      "address": "紫金港路21号西溪天堂国际旅游综合体2号杭州西溪悦榕庄酒店",
      "metadata": {
        "phone": null,
        "businessArea": "西溪",
        "mainTag": "住宿服务,宾馆酒店,五星级宾馆",
        "score": "5.0",
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": []
    },
    {
      "id": "B0H37SCCOQ",
      "name": "杭州西子湖四季酒店大堂",
      "latitude": "30.251189",
      "longitude": "120.127866",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "2793",
      "address": "灵隐路与赵公堤支路交叉口东南120米",
      "metadata": {
        "phone": "0571-8829****",
        "businessArea": "西湖",
        "mainTag": "住宿服务,宾馆酒店,五星级宾馆",
        "score": null,
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": []
    },
    {
      "id": "B0IA3MQ0A8",
      "name": "杭州西溪喜来登度假大酒店大堂",
      "latitude": "30.267679",
      "longitude": "120.088608",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "3232",
      "address": "紫金港路西溪天堂国际旅游综合体1号杭州西溪喜来登度假大酒店",
      "metadata": {
        "phone": null,
        "businessArea": "西溪",
        "mainTag": "住宿服务,宾馆酒店,五星级宾馆",
        "score": null,
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": []
    },
    {
      "id": "B0IAFA7FME",
      "name": "华北饭店大堂",
      "latitude": "30.253575",
      "longitude": "120.133513",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "3398",
      "address": "北山路栖霞岭18号华北饭店",
      "metadata": {
        "phone": null,
        "businessArea": "西湖",
        "mainTag": "住宿服务,宾馆酒店,五星级宾馆",
        "score": null,
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": []
    },
    {
      "id": "B0FFKWA9KW",
      "name": "杭州花家山庄-杜鹃楼",
      "latitude": "30.222685",
      "longitude": "120.131430",
      "types": "住宿服务|宾馆酒店|五星级宾馆",
      "typeCode": "100102",
      "provinceName": "浙江省",
      "provinceCode": "330000",
      "cityName": "杭州市",
      "cityCode": "0571",
      "districtName": "西湖区",
      "districtCode": "330106",
      "distanceMeter": "3523",
      "address": "三台山路25号",
      "metadata": {
        "phone": "0571-8797****",
        "businessArea": "西湖",
        "mainTag": "住宿服务,宾馆酒店,五星级宾馆",
        "score": null,
        "dailyOpeningHours": null,
        "weeklyOpeningDays": null,
        "averageSpend": null
      },
      "images": []
    }
  ]
}

错误码

HTTP Status

错误码

错误信息

说明

400

Throttling.User

Request was denied due to user flow control.

用户限流错误

400

MissingParameter

Required parameter xxx is not found.

请求参数错误

403

NotActivate

Please activate POI search service.

未开通POI搜索服务

403

NotAuthorised

Please authorize the AliyunIQSFullAccess privilege to the sub-account.

子账号未被授权IQS权限

500

InternalServerError

An unexpected error occurred

系统内部错误

500

ServiceUnavailable

Service unavailable

服务不可用

SDK

SDK下载

服务接入点

地域名称

地域ID

公网接入地址

华北3（张家口）

cn-zhangjiakou

iqs.cn-zhangjiakou.aliyuncs.com

示例代码

以Java SDK配置和调用为例

  • SDK配置

通常建议使用最新版，以下内容仅为示例

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>iqs20240712</artifactId>
    <version>3.1.0</version>
</dependency>

  • 客户端配置

@Configuration
public class ClientConfiguration {

    @Bean
    public Client clientConfig() throws Exception {
        Config config = new Config();
        config.setAccessKeyId("XXX");
        config.setAccessKeySecret("XXX");
        config.setEndpoint("iqs.cn-zhangjiakou.aliyuncs.com");
        config.setConnectTimeout(8000);
        Client client = new Client(config);
        return client;
    }
    
}

  • 调用示例

CommonQueryBySceneRequest queryAttractionsRequest = new CommonQueryBySceneRequest();
CommonAgentQuery commonAgentQuery = new CommonAgentQuery();
commonAgentQuery.setQuery("杭州西湖附近的高档酒店");
commonAgentQuery.setQuerySceneEnumCode(QuerySceneEnum.HOTEL.getCode());
queryAttractionsRequest.setBody(commonAgentQuery);
try {
    CommonQueryBySceneResponse commonQueryBySceneResponse = client.commonQueryByScene(queryAttractionsRequest);
    System.out.println(JSON.toJSONString(commonQueryBySceneResponse));
} catch (Exception e) {
    //log error
}
上一篇：SDK下一篇：操作指南