为什么选择百度地图
全部服务产品
开发者频道
定价
登录
多边形区域检索
下载开发文档
接口说明

开发者可使用多边形区域检索传入多个坐标对，首尾坐标对需相同，坐标对用”,”分割。

两顶点坐标对。即可获取地点（POI）基础或详细地理信息。

多边形区域检索为高级权限，如有需求请提交【工单】咨询。

API服务地址

http://api.map.baidu.com/place/v2/search?query=银行&bounds=39.915,116.404,39.975,116.414&output=json&ak=您的密钥
//GET请求

请求参数
参数名称参数含义示例字段类型必选
query

检索关键字。圆形区域检索和多边形区域内检索支持多个关键字并集检索，不同关键字间以$符号分隔，最多支持10个关键字检索。如:银行$酒店
如果需要按POI分类进行检索，请将分类通过query参数进行设置，如query=美食

天安门string(45)是
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

string(50)是
ak

开发者的访问密钥，必填项。v2之前该属性为key。申请密钥

string(50)是
tag

检索分类偏好，与query组合进行检索，多个分类以","分隔 （POI分类），如果需要严格按分类检索，请通过query参数设置

美食string(50)否
extensions_adcode是否召回国标行政区划编码，true（召回）、false（不召回）true、falsestring(50)否
scope检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息1、2string(50)否
output输出格式为json或者xmljson或xmlstring(50)否
filter检索过滤条件。当scope取值为2时，可以设置filter进行排序。industry_type：行业类型，注意：设置该字段可提高检索速度和过滤精度，取值有： hotel（宾馆）；cater（餐饮）；life（生活娱乐） sort_name：排序字段，根据industry_type字段的值而定。 1、industry_type为hotel时，sort_name取值有： default（默认）；price（价格）；total_score（好评）；level（星级）；health_score（卫生）；distance（距离排序，需结合center字段一起使用） 2、industry_type为cater时，sort_name取值有： default（默认）；taste_rating（口味）；price（价格）；overall_rating（好评）；service_rating（服务）；distance（距离排序，需结合center字段一起使用） 3、industry_type为life时，sort_name取值有： default（默认）；price（价格）；overall_rating（好评）；comment_num（服务）；distance（距离排序，需结合center字段一起使用）sort_rule：排序规则：0（从高到低），1（从低到高）price_section：价格区间groupon：是否有团购：1（有），0（无）discount：是否有打折：1（有），0（无）sort_rule:1string(50)否
coord_type

传入的坐标类型，1（wgs84ll即GPS经纬度），2（gcj02ll即国测局经纬度坐标），3（bd09ll即百度经纬度坐标），4（bd09mc即百度米制坐标）注："ll为小写LL"坐标详细说明

1、2、3(默认)、4int否
ret_coordtype

返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标坐标详细说明

gcj02llstring(50)否
page_size单次召回POI数量，默认为10条记录，最大返回20条。多关键字检索时，返回的记录数为关键字个数*page_size。10int否
page_num分页页码，默认为0,0代表第一页，1代表第二页，以此类推。常与page_size搭配使用，仅当返回结果为poi时可以翻页。0、1、2int否
sn

开发者的权限签名。sn校验说明

string(50)可选，若开发者所用AK的校验方式为SN校验时该参数必须。
timestamp设置sn后该值必填。string(50)设置sn后该值必填。
photo_show是否输出图片信息：true(输出) 、false(不输出)true、falsebool否
返回参数
返回参数类型备注
statusInt本次API访问状态，如果成功返回0，如果失败返回其他数字。（见服务状态码）
messagestring对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。
totalintPOI检索总数，开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的，单次请求total最多为150。
result_typestringregion_type 行政区划类型;address_type 结构化地址类型;poi_type poi类型;city_type 城市类型
results返回的结果
namestringpoi名称
locationobjectpoi经纬度坐标
latfloat纬度值
lngfloat经度值
addressstringpoi地址信息
provincestring所属省份
citystring所属城市
areastring所属区县
adcodeint行政区划代码
telephonestringpoi电话信息
uidstringpoi的唯一标识，可用于详情检索
statusstringPOI的状态：
空（代表正常营业）
推算位置（代表开放/营业/办公状态可能有变化）
暂停营业
可能已关闭
已关闭
注意：该功能为高级付费功能，您可提交工单咨询
street_idstring街景图id
detailstring是否有详情页：1有，0没有
detail_infoobjectpoi的扩展信息，仅当scope=2时，显示该字段，不同的poi类型，显示的detail_info字段不同。
classified_poi_tagstringPOI展示分类（细致分类）
distanceint32距离中心点的距离，圆形区域检索时返回
typestring所属分类，如hotel、cater。
tagstring标签
labelstring标签细分解释，比如停车场标签（地上停车场/地下停车场），知名景区标签（几A级景区），酒店标签（什么类型酒店）等
navi_locationobjectPOI对应的导航引导点坐标。大型面状POI的导航引导点，一般为各类出入口，方便结合导航、路线规划等服务使用
lngfloat导航引导点经度
latfloat导航引导点纬度
aliasarraypoi别名
detail_urlstringpoi的详情页
childrenpoi子点数据，若某poi无子点，该字段为空
uidstringpoi子点的唯一标示，可用于详情检索
namestringpoi子点名称
show_namestringpoi子点简要名称
tagstringpoi子点类别
locationobjectpoi子点坐标 {"lat":39.911318,"lng":116.402284}, // lat poi子点纬度 , lng poi子点经度
addressstringpoi子点地址
pricestringpoi商户的价格
shop_hoursstring营业时间
overall_ratingstring总体评分
taste_ratingstring口味评分
service_ratingstring服务评分
environment_ratingstring环境评分
facility_ratingstring星级（设备）评分
hygiene_ratingstring卫生评分
technology_ratingstring技术评分
image_numstring图片数
groupon_numint团购数
discount_numint优惠数
comment_numstring评论数
favorite_numstring收藏数
checkin_numstring签到数
brandstringpoi对应的品牌（如加油站中的『中石油』、『中石化』）
content_tagstringpoi标签信息
photosarraypoi图片的下载链接。注意：该功能为高级付费功能，您可提交工单咨询。
如您需要获取POI图片及POI营业状态，请点击获取POI图片，获取POI营业状态。
示例代码
填写您的AK

输入AK可生成包含IP/SN校验方式的代码

<?php 
    // 此处填写你在控制台-应用管理-创建应用后获取的AK
    $ak = '您的AK';
    
    // 发起一个http get请求，并返回请求的结果
    // $url字段为请求的地址
    // $param字段为请求的参数
    function request_get($url = '', $param = array()) {
        if (empty($url) || empty($param)) {
            return false;
        }
        
        $getUrl = $url . "?" . http_build_query($param);
        $curl = curl_init(); // 初始化curl
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); // 跳过证书检查   
        curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查SSL加密算法是否存在
        curl_setopt($curl, CURLOPT_URL, $getUrl); // 抓取指定网页
        curl_setopt($curl, CURLOPT_TIMEOUT, 1000); // 设置超时时间1秒
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // curl不直接输出到屏幕
        curl_setopt($curl, CURLOPT_HEADER, 0); // 设置header
        $data = curl_exec($curl); // 运行curl


        if (!$data) {
            print("an error occured in function request_get(): " . curl_error($curl) . "\n");
        }


        curl_close($curl);
        
        return $data;
    }


    // 请求地址
    $url = 'https://api.map.baidu.com/place/v2/search';
    
    // 构造请求参数
    $param['query']   = '银行';
    $param['bounds']   = '39.915,116.404,39.975,116.414';
    $param['output']   = 'json';
    $param['ak']   = $ak;


    $res = request_get($url, $param);


    // 将原始返回的结果打印出来
    print("请求的原始返回结果为:\n");
    print($res . "\n");
?>
{
    "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": ""
      }
    ]
  }
在线运行
参数值备注必选
query
检索关键字。多边形区域内检索支持多个关键字并集检索，不同关键字间以$符号分隔，最多支持10个关键字检索，如:银行$酒店。如果需要按POI分类进行检索，请将分类通过query参数进行设置，如query=美食是
bounds
检索多边形区域。需传入多个坐标对集合，坐标对用','分割，首尾坐标对需相同。多边形为矩形时，可传入左下右上两顶点坐标对。是
output
输出格式为json或者xml否

上一篇

行政区划区域检索

下一篇

圆形区域检索

本篇文章对您是否有帮助？