周边搜索

更新时间:

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

周边搜索

通过经纬度查询附近的地点

API定义

接口名称

NearbySearchNova

请求参数

参数名

含义及规则

是否必须

缺省值

参数样例

longitude

圆形区域检索中心点的经度

必填

116.310918

latitude

圆形区域检索中心点的纬度

必填

39.992873

radius

搜索半径,单位:米

可选

1000

3000

keywords

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

可选

餐厅

types

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

可选

GAS_STATION|CNG_STATION|CAR_WASH|CHARGING_STATION|CAR_SALES|

page

请求页码

可选

1

1

size

当前分页展示的数据条数

可选

20

10

cityLimit

指定城市数据召回限制

可选

false

false

sortRule

规定返回结果的排序规则(按距离排序:distance;综合排序:weight)

可选

distance

distance

响应参数

参数名

类型

说明

requestId

string

请求id

success

bool

接口调用是否成功

code

string

状态码

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": "1-6788b6d0-15704a02-8b3829fbe431",
  "success": true,
  "code": 200,
  "message": "ok",
  "data": [
    {
      "types": "餐饮服务|中餐厅|中餐厅",
      "metadata": {
        "score": "4.6",
        "averageSpend": "22.00",
        "businessArea": "西苑",
        "phone": "010-6276****",
        "dailyOpeningHours": "11:00-14:00 17:00-21:00",
        "weeklyOpeningDays": "每天",
        "mainTag": "食堂",
        "tag": "瓦罐汤"
      },
      "images": [
        {
          "url": "https://aos-comment.amap.com/B000A8UNZV/comment/f0a5ca9b58a31f63f8af51f459f75e4b_2048_2048_80.jpg"
        },
        {
          "url": "https://aos-comment.amap.com/B000A8UNZV/comment/b5131dd3fcc9d06f9c4464af3daccc53_2048_2048_80.jpg"
        },
        {
          "url": "https://aos-comment.amap.com/B000A8UNZV/comment/51e4d565c61cd26eb1c136ba60512a5e_2048_2048_80.jpg"
        }
      ],
      "districtCode": "110108",
      "address": "颐和园路5号北京大学第二教学楼西门口正对面",
      "districtName": "海淀区",
      "provinceCode": "110000",
      "cityCode": "010",
      "latitude": "39.989027",
      "typeCode": "050100",
      "cityName": "北京市",
      "name": "北京大学农园餐厅",
      "distanceMeter": "445",
      "id": "B000A8UNZV",
      "provinceName": "北京市",
      "longitude": "116.312348"
    },
    {
      "types": "餐饮服务|外国餐厅|西餐厅(综合风味)",
      "metadata": {
        "score": "4.7",
        "averageSpend": "83.00",
        "businessArea": "西苑",
        "phone": "010-6275****|010-6275****",
        "dailyOpeningHours": "09:00-21:00",
        "weeklyOpeningDays": "每天",
        "mainTag": "西餐",
        "tag": "小蛋糕,鸡排,牛排,薯条"
      },
      "images": [
        {
          "url": "http://store.is.autonavi.com/showpic/fb2d477da9b30bce716a58a373d698ac"
        },
        {
          "url": "https://aos-comment.amap.com/B0FFFDC91L/comment/71fa9e3f93ddcbeeba0b2c8eb704f644_2048_2048_80.jpg"
        },
        {
          "url": "https://aos-comment.amap.com/B0FFFDC91L/comment/3d7840d3ae18c34df8e8a0343bbd0987_2048_2048_80.jpg"
        }
      ],
      "districtCode": "110108",
      "address": "颐和园路16号",
      "districtName": "海淀区",
      "provinceCode": "110000",
      "cityCode": "010",
      "latitude": "39.990948",
      "typeCode": "050201",
      "cityName": "北京市",
      "name": "勺园西餐厅",
      "distanceMeter": "502",
      "id": "B0FFFDC91L",
      "provinceName": "北京市",
      "longitude": "116.305588"
    },
    {
      "types": "餐饮服务|外国餐厅|西餐厅(综合风味)",
      "metadata": {
        "score": "4.0",
        "averageSpend": "210.00",
        "businessArea": "西苑",
        "phone": "010-8268****",
        "mainTag": "西餐"
      },
      "images": [
        {
          "url": "http://store.is.autonavi.com/showpic/53f8cb1b7fee201a4afd41cca2bf12b1"
        },
        {
          "url": "http://store.is.autonavi.com/showpic/620c9b19ecd082d46eb1c17250ec74de"
        },
        {
          "url": "http://store.is.autonavi.com/showpic/933df93ff87eb8d9faf5d0357e11148f"
        }
      ],
      "districtCode": "110108",
      "address": "中关村北大街127号北大博雅国际酒店1层",
      "districtName": "海淀区",
      "provinceCode": "110000",
      "cityCode": "010",
      "latitude": "39.997865",
      "typeCode": "050201",
      "cityName": "北京市",
      "name": "北大博雅国际酒店西餐厅",
      "distanceMeter": "592",
      "id": "B0FFK1XX12",
      "provinceName": "北京市",
      "longitude": "116.313334"
    },
    {
      "types": "餐饮服务|中餐厅|中餐厅",
      "metadata": {
        "score": "4.8",
        "averageSpend": "52.00",
        "businessArea": "西苑",
        "phone": "010-6276****",
        "dailyOpeningHours": "10:00-23:00",
        "weeklyOpeningDays": "每天",
        "mainTag": "北京菜"
      },
      "images": [
        {
          "url": "https://aos-comment.amap.com/B0FFGIIKS4/comment/81BE04A1_B6EE_4F40_9430_770A11DBE981_L0_001_1284_1147_1730438734251_61310843.jpg"
        },
        {
          "url": "http://store.is.autonavi.com/showpic/f37a7b145b1e7d82d31620299d2891eb"
        },
        {
          "url": "http://store.is.autonavi.com/showpic/5b37ea0de398139bb025aa36d79add18"
        }
      ],
      "districtCode": "110108",
      "address": "颐和园路5号北京大学45号",
      "districtName": "海淀区",
      "provinceCode": "110000",
      "cityCode": "010",
      "latitude": "39.988174",
      "typeCode": "050100",
      "cityName": "北京市",
      "name": "北京大学艺园餐厅",
      "distanceMeter": "620",
      "id": "B0FFGIIKS4",
      "provinceName": "北京市",
      "longitude": "116.307002"
    },
    {
      "types": "餐饮服务|中餐厅|中餐厅",
      "metadata": {
        "score": "4.0",
        "averageSpend": "43.00",
        "businessArea": "西苑",
        "phone": "010-6276****|1851525****",
        "dailyOpeningHours": "09:00-21:00",
        "weeklyOpeningDays": "每天",
        "mainTag": "北京菜"
      },
      "images": [],
      "districtCode": "110108",
      "address": "畅春园食堂三层",
      "districtName": "海淀区",
      "provinceCode": "110000",
      "cityCode": "010",
      "latitude": "39.993888",
      "typeCode": "050100",
      "cityName": "北京市",
      "name": "北京畅春园三层餐厅",
      "distanceMeter": "621",
      "id": "B0FFF642P2",
      "provinceName": "北京市",
      "longitude": "116.303747"
    },
    {
      "types": "餐饮服务|中餐厅|中餐厅",
      "metadata": {
        "score": "4.7",
        "averageSpend": "132.00",
        "phone": "010-6275****|010-6275****",
        "dailyOpeningHours": "11:30-21:00",
        "weeklyOpeningDays": "每天",
        "mainTag": "创意菜"
      },
      "images": [
        {
          "url": "https://aos-comment.amap.com/B000AA4281/comment/content_media_external_images_media_100002521_1727767502417_74266199.jpg"
        },
        {
          "url": "https://aos-comment.amap.com/B000AA4281/comment/content_media_external_images_media_100002521_1727767512901_97807208.jpg"
        },
        {
          "url": "https://aos-comment.amap.com/B000AA4281/comment/content_media_external_images_media_100002521_1727767502416_10731974.jpg"
        }
      ],
      "districtCode": "110108",
      "address": "中关村北大街126号北京大学中关新园2号楼1层(近北大东门)",
      "districtName": "海淀区",
      "provinceCode": "110000",
      "cityCode": "010",
      "latitude": "39.990170",
      "typeCode": "050100",
      "cityName": "北京市",
      "name": "怡园中餐厅",
      "distanceMeter": "644",
      "id": "B000AA4281",
      "provinceName": "北京市",
      "longitude": "116.317606"
    },
    {
      "types": "餐饮服务|中餐厅|中餐厅",
      "metadata": {
        "score": "4.4",
        "averageSpend": "70.00",
        "phone": "010-6275****|010-6275****",
        "dailyOpeningHours": "11:00-14:30 17:00-21:00",
        "weeklyOpeningDays": "每天",
        "mainTag": "创意菜"
      },
      "images": [
        {
          "url": "http://store.is.autonavi.com/showpic/0cf29af79e1c0c8cf7ec6c5f94711b2e"
        },
        {
          "url": "http://store.is.autonavi.com/showpic/08fd18d6f95369d20b6fbc2a450b1a86"
        },
        {
          "url": "http://store.is.autonavi.com/showpic/9378f99f084039e48fa2e890c1a2c37d"
        }
      ],
      "districtCode": "110108",
      "address": "中关村北大街126号北京大学中关新园5号楼1层",
      "districtName": "海淀区",
      "provinceCode": "110000",
      "cityCode": "010",
      "latitude": "39.989287",
      "typeCode": "050100",
      "cityName": "北京市",
      "name": "和园主题餐厅",
      "distanceMeter": "781",
      "id": "B000A8WA8P",
      "provinceName": "北京市",
      "longitude": "116.318799"
    },
    {
      "types": "餐饮服务|中餐厅|中餐厅",
      "metadata": {
        "score": "3.9",
        "businessArea": "万泉河",
        "mainTag": "食堂"
      },
      "images": [
        {
          "url": "https://aos-comment.amap.com/B0KGCLTASF/comment/2e8e8a6fb25c027acafec920f9576050_2048_2048_80.jpg"
        },
        {
          "url": "https://aos-comment.amap.com/B0KGCLTASF/comment/8d9eb61156c7f8c0e9a620541490f61e_2048_2048_80.jpg"
        },
        {
          "url": "https://aos-comment.amap.com/B0KGCLTASF/comment/329f136fe7a2cb69413b37a602fb0f4d_2048_2048_80.jpg"
        }
      ],
      "districtCode": "110108",
      "address": "颐和园路与海淀路交叉口西北140米",
      "districtName": "海淀区",
      "provinceCode": "110000",
      "cityCode": "010",
      "latitude": "39.987345",
      "typeCode": "050100",
      "cityName": "北京市",
      "name": "未来科技大厦餐厅",
      "distanceMeter": "817",
      "id": "B0KGCLTASF",
      "provinceName": "北京市",
      "longitude": "116.304615"
    },
    {
      "types": "餐饮服务|中餐厅|中餐厅",
      "metadata": {
        "score": "4.8",
        "averageSpend": "17.00",
        "phone": "010-6278****",
        "dailyOpeningHours": "08:00-20:30",
        "weeklyOpeningDays": "每天",
        "mainTag": "食堂",
        "tag": "麻辣香锅"
      },
      "images": [
        {
          "url": "https://aos-comment.amap.com/B000A7R5S9/comment/f3bf6bd16faa9aea3ba2f1aee3746ee6_2048_2048_80.jpg"
        },
        {
          "url": "https://aos-comment.amap.com/B000A7R5S9/comment/69aaa41ebe034f69ebcf7aed2a4d3f36_2048_2048_80.jpg"
        },
        {
          "url": "https://aos-comment.amap.com/B000A7R5S9/comment/6f06edf67b0356fee848983c06e45e9e_2048_2048_80.jpg"
        }
      ],
      "districtCode": "110108",
      "address": "双清路30号清华大学",
      "districtName": "海淀区",
      "provinceCode": "110000",
      "cityCode": "010",
      "latitude": "39.998357",
      "typeCode": "050100",
      "cityName": "北京市",
      "name": "寓园教工餐厅",
      "distanceMeter": "926",
      "id": "B000A7R5S9",
      "provinceName": "北京市",
      "longitude": "116.319091"
    },
    {
      "types": "餐饮服务|中餐厅|中餐厅",
      "metadata": {
        "score": "4.4",
        "averageSpend": "15.00",
        "phone": "010-6278****",
        "mainTag": "食堂",
        "tag": "麻辣烫"
      },
      "images": [
        {
          "url": "http://store.is.autonavi.com/showpic/5c9967886e26efb0aabd965d1c0acd00"
        },
        {
          "url": "http://store.is.autonavi.com/showpic/53a244a4a310b133764f087a"
        },
        {
          "url": "http://store.is.autonavi.com/showpic/023508e4848639aae8567073ecc202f5"
        }
      ],
      "districtCode": "110108",
      "address": "清华南路1号清华大学",
      "districtName": "海淀区",
      "provinceCode": "110000",
      "cityCode": "010",
      "latitude": "39.994663",
      "typeCode": "050100",
      "cityName": "北京市",
      "name": "清华大学家园教工餐厅",
      "distanceMeter": "993",
      "id": "B000A9P9GY",
      "provinceName": "北京市",
      "longitude": "116.322336"
    }
  ]
}

枚举定义

目标类型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

事件活动