关键词搜索

更新时间:

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

关键词搜索

通过关键词搜索地点。

API定义

接口名称

PlaceSearchNova

请求参数

参数名

含义及规则

是否必须

缺省值

参数样例

keywords

需要被检索的地点文本信息。只支持一个关键字 ,文本总长度不可超过80字符

必填

五星级酒店

region

搜索的区域,支持城市中文名称和行政地区编码。

可选

无,默认全国范围内搜索

杭州市

types

目标类型的枚举值,以 “|” 标记分隔,参考枚举定义。

可选

GAS_STATION|CNG_STATION|CAR_WASH|CHARGING_STATION|CAR_SALES|

page

请求页码

可选

1

1

size

当前分页展示的数据条数

可选

20

20

cityLimit

指定城市数据召回限制

可选

false

false

响应参数

参数名

类型

说明

requestId

string

请求id

success

bool

接口调用是否成功

code

integer

状态码

message

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

图片链接

示例

响应示例

{
  "requestId": "2FCBD99B-3E17-1660-9672-82BF24B05C26",
  "success": true,
  "code": 200,
  "message": "ok",
  "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"
    }
  ]
}

枚举定义

目标类型types枚举

Code

Value

说明

GAS_STATION

010100

加油站

CNG_STATION

010300

加气站

CAR_WASH

010500

洗车场

CHARGING_STATION

011100

充电站

CAR_SALES

020000

汽车销售

CAR_MAINTENANCE

030000

汽车维修

MOTORCYCLE_SERVICE

040000

摩托车服务相关

RESTAURANT

050000

餐馆、饭店

SHOPPING_SERVICE

060000

购物服务

LIFE_SERVICE

070000

生活服务

SPORTS_SERVICE

080000

体育休闲服务

HEALTHCARE_SERVICE

090000

医疗保健服务

HOTEL

100000

住宿服务

ATTRACTION

110000

风景名胜

COMMERCIAL_RESIDENTIAL

120000

商务住宅

GOVERNMENT_AGENCIES

130000

政府机构及社会团体

EDUCATION_CULTURAL_SERVICE

140000

科教文化服务

TRANSPORTATION_SERVICE

150000

交通设施服务

FINANCIAL_SERVICE

160000

金融保险服务

COMPANIES

170000

公司企业

ROAD_AUXILIARY_FACILITIES

180000

道路附属设施

GEOGRAPHICAL_NAMES_ADDRESS

190000

地名地址信息

PUBLIC_FACILITIES

200000

公共设施

EVENTS_ACTIVITIES

220000

事件活动