百度地图 API
使用准备
服务状态码
地点
地点检索及联想
地理编码
全球逆地理编码
坐标转换
地址解析聚合
城乡类型判别
时区
推荐上车点
路线
服务概览
轻量级路线规划
GET
骑行路线规划
GET
步行路线规划
GET
公交路线规划
GET
货车路线规划
GET
批量算路
物流路⽹计算
Powered by Hapydev
行政区划区域检索开发中
GET/place/v2/search?query=天安门、美食&region=北京、131（北京的code）、全国，等&ak=&tag=美食&city_limit=true、false&extensions_adcode=true、false&output=json或xml&scope=1、2&center=38.76623,116.43213&filter=sort_name:distance|sort_rule:1&coord_type=1&ret_coordtype=gcj02ll&page_size=10&page_num=0&sn=&timestamp=&photo_show=true&address_result=false&extenstions_town=false、true&language=en
创建时间: 2025-06-02 21:09
请求参数
Query 参数
参数名示例值是否必填参数类型描述说明
query天安门、美食是string检索关键字。行政区划区域检索不支持多关键字检索。如果需要按POI分类进行检索，请将分类通过query参数进行设置，如query=美食
region北京、131（北京的code）、全国，等是string检索行政区划区域（增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用city_limit参数），可输入行政区划名或对应cityCode
ak是string开发者的访问密钥，必填项。v2之前该属性为key。
tag美食是string检索分类偏好，与query组合进行检索，多个分类以","分隔 （POI分类），如果需要严格按分类检索，请通过query参数设置
city_limittrue、false是string区域数据召回限制，为true时，仅召回region对应区域内数据。
extensions_adcodetrue、false是string是否召回国标行政区划编码，true（召回）、false（不召回）
outputjson或xml是string输出格式为json或者xml
scope1、2是string检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息
center38.76623,116.43213是string传入poi坐标，辅助检索结果按照距离排序返回。注意：需要结合filter字段一起使用并结合coord_type字段说明该字段的坐标类型
filtersort_name:distance|sort_rule:1是string检索过滤条件。当scope取值为2时，可以设置filter进行排序。
coord_type1是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_showtrue是string是否输出图片信息：true(输出) 、false(不输出)
address_resultfalse是stringquery传入结构化地址（如：上地十街10号），检索结果返回数据的类型。若不传入该字段，默认召回门址数据，仅当address_result=false时，召回相应的POI数据
extenstions_townfalse、true是string当取值为true时，召回POI的乡镇街道信息
languageen是string指定输入参数和召回参数的语言类型，可支持的语言类型为英文
响应示例
成功响应
HTTP状态码：200
内容格式：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
可选
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字段不同。
响应示例
{
  "status": 0,
  "message": "ok",
  "result_type": "poi_type",
  "results": [
    {
      "name": "中国工商银行24小时自助银行(北京府学路支行)",
      "location": {
        "lat": 40.227332,
        "lng": 116.263379
      },
      "address": "北京市昌平区府学路福地家园7号楼07号1-2层",
      "province": "北京市",
      "city": "北京市",
      "area": "昌平区",
      "street_id": "22e11407287926b4d5b74e09",
      "detail": 1,
      "uid": "22e11407287926b4d5b74e09"
    },
    {
      "name": "中国工商银行24小时自助银行(北京分行中关村支行丰慧中路店)",
      "location": {
        "lat": 40.08189,
        "lng": 116.242144
      },
      "address": "丰慧中路7号",
      "province": "北京市",
      "city": "北京市",
      "area": "海淀区",
      "street_id": "dd33b83a0f8c6f55ab175a1f",
      "detail": 1,
      "uid": "dd33b83a0f8c6f55ab175a1f"
    },
    {
      "name": "中国工商银行ATM(昌平支行)",
      "location": {
        "lat": 40.21018,
        "lng": 116.244804
      },
      "address": "北京市昌平区科技园区超前路9号",
      "province": "北京市",
      "city": "北京市",
      "area": "昌平区",
      "street_id": "5508504dff802acbc7f0250d",
      "detail": 1,
      "uid": "5508504dff802acbc7f0250d"
    },
    {
      "name": "招商银行24小时自助银行(立水桥支行)",
      "location": {
        "lat": 40.046176,
        "lng": 116.421222
      },
      "address": "北京市朝阳区北苑路13号院1号楼1-9号",
      "province": "北京市",
      "city": "北京市",
      "area": "朝阳区",
      "street_id": "2e00c5ddfe1e6e62d6851f85",
      "detail": 1,
      "uid": "2e00c5ddfe1e6e62d6851f85"
    },
    {
      "name": "中国建设银行24小时自助银行(北京昌平天通北苑支行)",
      "location": {
        "lat": 40.083388,
        "lng": 116.420857
      },
      "address": "北京市昌平区东小口镇天通北苑一区甲4号楼3门(近地铁5号线天通苑站)",
      "province": "北京市",
      "city": "北京市",
      "area": "昌平区",
      "street_id": "ea4a3dc98279772e4e55471c",
      "detail": 1,
      "uid": "ea4a3dc98279772e4e55471c"
    },
    {
      "name": "中国建设银行ATM(北京昌平回龙观支行)",
      "location": {
        "lat": 40.09399,
        "lng": 116.350631
      },
      "address": "北京市昌平区龙回苑28号",
      "province": "北京市",
      "city": "北京市",
      "area": "昌平区",
      "street_id": "750368359a2e38af5e0d021b",
      "detail": 1,
      "uid": "750368359a2e38af5e0d021b"
    },
    {
      "name": "招商银行24小时自助银行(回龙观支行)",
      "location": {
        "lat": 40.085153,
        "lng": 116.344808
      },
      "address": "北京市昌平区龙冠商务中心1层",
      "province": "北京市",
      "city": "北京市",
      "area": "昌平区",
      "street_id": "5165c94b870f3ec5d92f289b",
      "detail": 1,
      "uid": "5165c94b870f3ec5d92f289b"
    },
    {
      "name": "招商银行24小时自助银行服务(望京融科支行)",
      "location": {
        "lat": 40.003785,
        "lng": 116.489532
      },
      "address": "北京市朝阳区望京东园523号融科望京中心A座101号",
      "province": "北京市",
      "city": "北京市",
      "area": "朝阳区",
      "street_id": "647a352e9bbbaa226268580a",
      "detail": 1,
      "uid": "647a352e9bbbaa226268580a"
    },
    {
      "name": "中国工商银行24小时自助银行(北新桥支行)",
      "location": {
        "lat": 39.949826,
        "lng": 116.423466
      },
      "address": "北京市东城区雍和宫大街52号",
      "province": "北京市",
      "city": "北京市",
      "area": "东城区",
      "street_id": "4a152d0030a8dc15f4b916d6",
      "detail": 1,
      "uid": "4a152d0030a8dc15f4b916d6"
    },
    {
      "name": "中国工商银行24小时自助银行服务(京奥嘉园支行)",
      "location": {
        "lat": 39.966871,
        "lng": 116.552054
      },
      "address": "东坝乡京奥家园186幢1-2号",
      "province": "北京市",
      "city": "北京市",
      "area": "朝阳区",
      "street_id": "f757e6eee5b37817260bd043",
      "detail": 1,
      "uid": "f757e6eee5b37817260bd043"
    }
  ]
}
最后更新: -
上一页
服务概览
下一页
GET多边形区域检索