百度地图 API
使用准备
服务状态码
地点
地点检索及联想
地理编码
全球逆地理编码
坐标转换
地址解析聚合
城乡类型判别
时区
推荐上车点
路线
服务概览
轻量级路线规划
GET
骑行路线规划
GET
步行路线规划
GET
公交路线规划
GET
货车路线规划
GET
批量算路
物流路⽹计算
Powered by Hapydev
多边形区域检索开发中
GET/place/v2/search?query=天安门&bounds=38.76623,116.43213,40.056878,116.30815,40.465,116.314,40.232,116.352,40.121,116.453,38.76623,116.43213&ak=&tag=美食&extensions_adcode=true&scope=1&output=json&filter=sort_rule:1&coord_type=3&ret_coordtype=gcj02ll&page_size=10&page_num=0&sn=&timestamp=&photo_show=false&extensions_town=false&language=en
创建时间: 2025-06-02 21:09
请求参数
Query 参数
参数名示例值是否必填参数类型描述说明
query天安门是string检索关键字。圆形区域检索和多边形区域内检索支持多个关键字并集检索，不同关键字间以$符号分隔，最多支持10个关键字检索。如:银行$酒店。如果需要按POI分类进行检索，请将分类通过query参数进行设置，如query=美食
bounds38.76623,116.43213,40.056878,116.30815,40.465,116.314,40.232,116.352,40.121,116.453,38.76623,116.43213是string检索多边形区域。需传入多个坐标对集合，坐标对用','分割，首尾坐标对需相同。多边形为矩形时，可传入左下右上两顶点坐标对。
ak是string开发者的访问密钥，必填项。v2之前该属性为key。
tag美食是string检索分类偏好，与query组合进行检索，多个分类以","分隔 （POI分类），如果需要严格按分类检索，请通过query参数设置
extensions_adcodetrue是string是否召回国标行政区划编码，true（召回）、false（不召回）
scope1是string检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息
outputjson是string输出格式为json或者xml
filtersort_rule:1是string检索过滤条件。当scope取值为2时，可以设置filter进行排序。
coord_type3是string传入的坐标类型，1（wgs84ll即GPS经纬度），2（gcj02ll即国测局经纬度坐标），3（bd09ll即百度经纬度坐标），4（bd09mc即百度米制坐标）
ret_coordtypegcj02ll是string返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标
page_size10是string单次召回POI数量，默认为10条记录，最大返回20条。多关键字检索时，返回的记录数为关键字个数*page_size。
page_num0是string分页页码，默认为0,0代表第一页，1代表第二页，以此类推。常与page_size搭配使用，仅当返回结果为poi时可以翻页。
sn是string开发者的权限签名。
timestamp是string设置sn后该值必填。
photo_showfalse是string是否输出图片信息：true(输出) 、false(不输出)
extensions_townfalse是string当取值为true时，召回POI的乡镇街道信息
languageen是string指定输入参数和召回参数的语言类型，可支持的语言类型为英文
响应示例
成功响应
HTTP状态码：500
内容格式：application/json
数据结构
statusinteger
可选
本次API访问状态，如果成功返回0，如果失败返回其他数字。
messagestring
可选
对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。
totalinteger
可选
POI检索总数，开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的，单次请求total最多为150。
result_typestring
可选
region_type 行政区划类型;address_type 结构化地址类型;poi_type poi类型;city_type 城市类型
resultsarray<object>
可选
返回的结果
namestring
可选
poi名称
locationobject
可选
poi经纬度坐标
latnumber
可选
纬度值
lngnumber
可选
经度值
addressstring
可选
poi地址信息
provincestring
可选
所属省份
citystring
可选
所属城市
areastring
可选
所属区县
townstring
可选
所属乡镇街道信息
adcodeinteger
可选
行政区划代码
telephonestring
可选
poi电话信息
uidstring
可选
poi的唯一标识，可用于详情检索
statusstring
可选
POI的状态：空（代表正常营业）推算位置（代表开放/营业/办公状态可能有变化）暂停营业可能已关闭已关闭
street_idstring
可选
街景图id
detailstring
可选
是否有详情页：1有，0没有
detail_infoobject
可选
poi的扩展信息，仅当scope=2时，显示该字段，不同的poi类型，显示的detail_info字段不同。
classified_poi_tagstring
可选
POI展示分类（细致分类）
distanceinteger
可选
距离中心点的距离，圆形区域检索时返回
typestring
可选
所属分类，如hotel、cater。
tagstring
可选
标签
labelstring
可选
标签细分解释，比如停车场标签（地上停车场/地下停车场），知名景区标签（几A级景区），酒店标签（什么类型酒店）等
navi_locationobject
可选
POI对应的导航引导点坐标。大型面状POI的导航引导点，一般为各类出入口，方便结合导航、路线规划等服务使用
lngnumber
可选
导航引导点经度
latnumber
可选
导航引导点纬度
aliasarray<string>
可选
poi别名
detail_urlstring
可选
poi的详情页
childrenarray<object>
可选
poi子点数据，若某poi无子点，该字段为空
uidstring
可选
poi子点的唯一标示，可用于详情检索
namestring
可选
poi子点名称
show_namestring
可选
poi子点简要名称
tagstring
可选
poi子点类别
locationobject
可选
poi子点坐标
latnumber
可选
poi子点纬度
lngnumber
可选
poi子点经度
addressstring
可选
poi子点地址
pricestring
可选
poi商户的价格
shop_hoursstring
可选
营业时间
overall_ratingstring
可选
总体评分
taste_ratingstring
可选
口味评分
service_ratingstring
可选
服务评分
environment_ratingstring
可选
环境评分
facility_ratingstring
可选
星级（设备）评分
hygiene_ratingstring
可选
卫生评分
technology_ratingstring
可选
技术评分
image_numstring
可选
图片数
groupon_numinteger
可选
团购数
discount_numinteger
可选
优惠数
comment_numstring
可选
评论数
favorite_numstring
可选
收藏数
checkin_numstring
可选
签到数
brandstring
可选
poi对应的品牌（如加油站中的『中石油』、『中石化』）
content_tagstring
可选
poi标签信息
photosarray<string>
可选
poi图片的下载链接。
响应示例
{
    "status": 0,
    "message": "ok",
    "result_type": "poi_type",
    "results": [
      {
        "name": "中国工商银行(北京地坛支行)",
        "location": {
          "lat": 39.966729,
          "lng": 116.413804
        },
        "address": "北京市东城区安定门外大街9号",
        "province": "北京市",
        "city": "北京市",
        "area": "东城区",
        "street_id": "50f7d1461f0208c472210bff",
        "telephone": "(010)84122100",
        "detail": 1,
        "uid": "50f7d1461f0208c472210bff",
        "status": ""
      },
      {
        "name": "北京银行(中轴路支行)",
        "location": {
          "lat": 39.957608,
          "lng": 116.404181
        },
        "address": "北京市东城区安德路16号",
        "province": "北京市",
        "city": "北京市",
        "area": "东城区",
        "street_id": "33ddf832c2d7244952e5c51e",
        "telephone": "(010)84882626",
        "detail": 1,
        "uid": "33ddf832c2d7244952e5c51e",
        "status": ""
      },
      {
        "name": "北京银行(沙滩支行)",
        "location": {
          "lat": 39.929113,
          "lng": 116.412448
        },
        "address": "北京市东城区北河沿大街97号",
        "province": "北京市",
        "city": "北京市",
        "area": "东城区",
        "street_id": "9ca676f2a814373a43e19275",
        "telephone": "95526",
        "detail": 1,
        "uid": "9ca676f2a814373a43e19275",
        "status": ""
      },
      {
        "name": "交通银行(北京和平里支行)",
        "location": {
          "lat": 39.96878,
          "lng": 116.410023
        },
        "address": "北京市朝阳区外馆东街51号",
        "province": "北京市",
        "city": "北京市",
        "area": "朝阳区",
        "street_id": "e56bf5e3064b7b440782c2ff",
        "telephone": "(010)64408115",
        "detail": 1,
        "uid": "e56bf5e3064b7b440782c2ff",
        "status": ""
      },
      {
        "name": "中国银行(安定门外支行)",
        "location": {
          "lat": 39.958013,
          "lng": 116.413657
        },
        "address": "北京市东城区安外大街191号",
        "province": "北京市",
        "city": "北京市",
        "area": "东城区",
        "street_id": "f4460918f2b3296ab11e36ff",
        "telephone": "(010)64400221",
        "detail": 1,
        "uid": "f4460918f2b3296ab11e36ff",
        "status": ""
      },
      {
        "name": "中国民生银行(北京安定门支行)",
        "location": {
          "lat": 39.971308,
          "lng": 116.41372
        },
        "address": "北京市朝阳区安定门外大街1号",
        "province": "北京市",
        "city": "北京市",
        "area": "朝阳区",
        "street_id": "53cebd509fbca9612a02e14c",
        "telephone": "(010)58295666",
        "detail": 1,
        "uid": "53cebd509fbca9612a02e14c",
        "status": "暂停营业"
      },
      {
        "name": "中国进出口银行(北京分行)",
        "location": {
          "lat": 39.934787,
          "lng": 116.412091
        },
        "address": "北京市东城区北河沿大街77号",
        "province": "北京市",
        "city": "北京市",
        "area": "东城区",
        "street_id": "6334ddeb6a99710bfea77863",
        "telephone": "(010)64099688",
        "detail": 1,
        "uid": "6334ddeb6a99710bfea77863",
        "status": ""
      },
      {
        "name": "中国民生银行(什刹海支行)",
        "location": {
          "lat": 39.939677,
          "lng": 116.411715
        },
        "address": "北京市东城区地安门东大街56号",
        "province": "北京市",
        "city": "北京市",
        "area": "东城区",
        "street_id": "6151f789e113de3cfda778e3",
        "telephone": "(010)83281583,95568",
        "detail": 1,
        "uid": "6151f789e113de3cfda778e3",
        "status": ""
      },
      {
        "name": "中国工商银行(北京和平北路东口支行)",
        "location": {
          "lat": 39.96859,
          "lng": 116.410324
        },
        "address": "北京市朝阳区外馆东街51号凯景铭座一层",
        "province": "北京市",
        "city": "北京市",
        "area": "朝阳区",
        "street_id": "4482d48423f9a3b33fe23125",
        "telephone": "(010)84123118",
        "detail": 1,
        "uid": "4482d48423f9a3b33fe23125",
        "status": ""
      },
      {
        "name": "中国民生银行(北京正义路支行)",
        "location": {
          "lat": 39.915492,
          "lng": 116.413403
        },
        "address": "北京市东城区南河沿大街109号",
        "province": "北京市",
        "city": "北京市",
        "area": "东城区",
        "street_id": "14cf81e3aae18d1914948ebb",
        "telephone": "(010)65284468",
        "detail": 1,
        "uid": "14cf81e3aae18d1914948ebb",
        "status": ""
      }
    ]
  }
最后更新: -
上一页
GET行政区划区域检索
下一页
GET圆形区域检索