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

周边搜索

更新时间：
我的收藏

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

周边搜索

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

API定义

请求参数

参数名

含义及规则

是否必须

缺省值

参数样例

longitude

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

必填

无

116.310918

latitude

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

必填

无

39.992873

radius

搜索半径，单位：米

可选

1000

3000

keywords

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

可选

无

餐厅

types

目标类型的枚举值，以 “|” 标记分隔

可选

无

ATTRACTION|RESTAURANT|HOTEL|GAS_STATION

page

请求第几分页

可选

1

1

size

当前分页展示的数据条数

可选

20

10

响应参数

参数名

类型

说明

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",
        "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"
    }
  ],
  "success": true
}

枚举定义

目标类型types枚举

Code

Value

说明

GAS_STATION

010100

加油站

RESTAURANT

050000

餐馆、饭店

HOTEL

100100

酒店

ATTRACTION

110000

景点

上一篇：关键词搜索下一篇：地理编码
文档推荐