周边查询-基础API-关键词搜索_信息查询服务(IQS)-阿里云帮助中心

本文介绍通过阿里云OpenAPI SDK调用周边查询-基础API-关键词搜索的方法以及参数说明。

关键词搜索

通过关键词搜索地点。

API定义

请求参数

参数名	含义及规则	是否必须	缺省值	参数样例
keywords	需要被检索的地点文本信息。只支持一个关键字，文本总长度不可超过80字符	必填	无	五星级酒店
region	搜索的区域，支持城市中文名称和行政地区编码。	可选	无，默认全国范围内搜索	杭州市
types	目标类型的枚举值，以 “\|” 标记分隔	可选	无	ATTRACTION\|RESTAURANT\|HOTEL\|GAS_STATION
page	请求第几分页	可选	1	1
size	当前分页展示的数据条数	可选	20	20

响应参数

参数名			类型	说明
success			bool	接口调用是否成功
errorCode			integer	错误码
errorMessage			string	错误信息
data			list	返回的地点数据列表
	id		string	地点的唯一标识
	name		string	地点名称
	longitude		string	地点的经度
	latitude		string	地点的纬度
	types		string	地点的类型
	typeCode		string	地点的poi类型码
	provinceName		string	地点所属省份
	provinceCode		string	地点所属省份编码
	cityName		string	地点所属城市
	cityCode		string	地点所属城市编码
	districtName		string	地点所属区域
	districtCode		string	地点所属区域编码
	address		string	地点的详细地址
	distanceMeter		string	距离，单位米
	metadata		object	地点的商业信息相关
		businessArea	string	地点所属商圈
		mainTag	string	地点的主标签
		score	string	评分，仅部分可返回
		dailyOpeningHours	string	地点的日营业时间
		weeklyOpeningDays	string	地点的周营业时间
		averageSpend	string	人均消费
		tag	string	特色内容
		phone	string	联系电话
	images		list	地点的图片列表
		title	string	图片名称
		url	string	图片链接

示例

响应示例

{
  "data": [
    {
      "types": "住宿服务|宾馆酒店|四星级宾馆|餐饮服务|餐饮相关场所|餐饮相关",
      "metadata": {
        "score": "4.6",
        "phone": "029-8735****|029-8735****|029-8735****,6604",
        "mainTag": "五星级酒店",
        "tag": "自助早餐,自助餐,特色小吃,魏家凉皮"
      },
      "images": [
        {
          "title": "大堂",
          "url": "http://store.is.autonavi.com/showpic/d5ac77604ccf2117c0e770d1565708b6"
        },
        {
          "title": "外观",
          "url": "http://store.is.autonavi.com/showpic/739b98153f468f37f83b288621984fe5"
        },
        {
          "title": "二层铁板烧包厢",
          "url": "http://store.is.autonavi.com/showpic/566abde14dd5499d4ae4cf58fc4adb80"
        }
      ],
      "districtCode": "610102",
      "address": "解放路177号",
      "districtName": "新城区",
      "provinceCode": "610000",
      "cityCode": "029",
      "latitude": "34.274187",
      "typeCode": "100103|050000",
      "cityName": "西安市",
      "name": "西安阳光国际大酒店",
      "id": "B001D098ZJ",
      "provinceName": "陕西省",
      "longitude": "108.963499"
    },
    {
      "types": "住宿服务|宾馆酒店|宾馆酒店|商务住宅|产业园区|产业园区",
      "metadata": {
        "score": "4.7",
        "phone": "029-8385****",
        "dailyOpeningHours": "24小时营业",
        "weeklyOpeningDays": "每天",
        "mainTag": "豪华型",
        "tag": "小海鲜,凤梨酥,料理,自助火锅,鸡尾酒,泡汤,自助早餐,牛肉火锅自助,皮皮虾,自助烧烤,点心,自助餐"
      },
      "images": [
        {
          "url": "http://store.is.autonavi.com/showpic/764837c9bdcd9460bce94e831802157a"
        },
        {
          "title": "Logo",
          "url": "http://store.is.autonavi.com/showpic/67045cef3dd867820fb6ff3f2ff6d9b4"
        },
        {
          "url": "http://store.is.autonavi.com/showpic/78a8b1f62f233605e403c0ab883d4990"
        }
      ],
      "districtCode": "610115",
      "address": "陕鼓大道8号(西花园地铁站B西南口步行370米)",
      "districtName": "临潼区",
      "provinceCode": "610000",
      "cityCode": "029",
      "latitude": "34.369690",
      "typeCode": "100100|120100",
      "cityName": "西安市",
      "name": "长安先导国际创新人才交流中心",
      "id": "B001D06JOB",
      "provinceName": "陕西省",
      "longitude": "109.198049"
    },
    {
      "types": "住宿服务|宾馆酒店|宾馆酒店",
      "metadata": {
        "score": "4.9",
        "businessArea": "南院门",
        "phone": "029-8962****",
        "mainTag": "豪华型",
        "tag": "下午茶"
      },
      "images": [
        {
          "title": "外观",
          "url": "http://store.is.autonavi.com/showpic/171833cf8a775e83650a0eba16885271"
        },
        {
          "url": "http://store.is.autonavi.com/showpic/a9f840af68586f2e7643da424d5b615c"
        },
        {
          "title": "Logo",
          "url": "http://store.is.autonavi.com/showpic/d694001871dc1d3cb90bcc0b80343426"
        }
      ],
      "districtCode": "610103",
      "address": "粉巷中段南院门10号(南大街粉巷向西400米)",
      "districtName": "碑林区",
      "provinceCode": "610000",
      "cityCode": "029",
      "latitude": "34.255699",
      "typeCode": "100100",
      "cityName": "西安市",
      "name": "西安东舍酒店(钟鼓楼回民街店)",
      "id": "B0FFGIQD2T",
      "provinceName": "陕西省",
      "longitude": "108.941770"
    }
  ],
  "success": true
}

枚举定义

目标类型types枚举

Code	Value	说明
GAS_STATION	010100	加油站
RESTAURANT	050000	餐馆、饭店
HOTEL	100100	酒店
ATTRACTION	110000	景点