百度地图 API

使用准备

服务状态码

地点

地点检索及联想

地理编码

全球逆地理编码

坐标转换

地址解析聚合

城乡类型判别

时区

推荐上车点

路线

服务概览

轻量级路线规划

GET

骑行路线规划

GET

步行路线规划

GET

公交路线规划

GET

货车路线规划

GET

批量算路

物流路⽹计算

地点输入提示开发中

GET/place/v2/suggestion?query=天安门&region=北京&ak=E4805d16**********707cdc962045&city_limit=true&location=40.047857537164,116.31353434477&coord_type=3&ret_coordtype=gcj02ll&output=json&sn=&timestamp=&language=en

创建时间: 2025-06-02 21:09

请求参数

Query 参数

参数名	示例值	是否必填	参数类型	描述说明
query	天安门	是	string	输入建议关键字（支持拼音）
region	北京	是	string	支持城市及对应百度编码
ak	E4805d16**********707cdc962045	是	string	开发者访问密钥
city_limit	true	是	string	取值为"true"，仅返回region中指定城市检索结果
location	40.047857537164,116.31353434477	是	string	传入location参数后，是综合各种相关性排序的，location参数只是其中一个因素，但不会严格按距离排序决定最终的排序
coord_type	3	是	string	传入的坐标类型，可选参数，用于标注请求中「location」参数使用的坐标类型
ret_coordtype	gcj02ll	是	string	返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标
output	json	是	string	返回数据格式，可选json、xml两种
sn		是	string	用户的权限签名
timestamp		是	string	设置sn后该值必选
language	en	是	string	指定输入参数和召回参数的语言类型，可支持的语言类型为英文

响应示例

成功返回地点推荐列表

HTTP状态码：500

内容格式：application/json

数据结构

statusinteger

可选

本次API访问状态，如果成功返回0，如果失败返回其他数字。

messagestring

可选

对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。

resultarray<object>

可选

namestring

可选

poi名称

locationobject

可选

uidstring

可选

poi的唯一标识,ID

provincestring

可选

所属省份

citystring

可选

所属城市

cityidinteger

可选

百度城市编码

districtstring

可选

区县

adcodeinteger

可选

行政区划代码

businessstring

可选

商圈

tagstring

可选

poi分类

addressstring

可选

poi地址

childrenarray<object>

可选

响应示例

{
    "status":0,
    "message":"ok",
    "result":[
        {
            "name":"天安门广场",
            "location":{
                "lat":39.909652,
                "lng":116.404177
            },
            "uid":"c9b5fb91d49345bc5d0d0262",
            "province":"北京市",
            "city":"北京市",
            "district":"东城区",
            "business":"",
            "cityid":"131",
            "tag":"旅游景点",
            "address":"北京市-东城区-东长安街",
            "children":[
                {
                    "uid":"797c4f6023068d0ceedfcaf9",
                    "name":"天安门广场-出入口 北京市东城区",
                    "show_name":"出入口"
                },
                {
                    "uid":"ad764cbdedc637ec6d3e1b91",
                    "name":"天安门广场-出口 北京市东城区",
                    "show_name":"出口"
                }
            ],
            "adcode":"110101"
        },
        {
            "name":"天安门",
            "location":{
                "lat":39.915119,
                "lng":116.403963
            },
            "uid":"65e1ee886c885190f60e77ff",
            "province":"北京市",
            "city":"北京市",
            "district":"东城区",
            "business":"",
            "cityid":"131",
            "tag":"古建筑",
            "address":"北京市-东城区-长安街",
            "children":[
                
            ],
            "adcode":"110101"
        },
        {
            "name":"天安门东-地铁站",
            "location":{
                "lat":39.914082,
                "lng":116.407913
            },
            "uid":"940aeb3c98d5a0218a2fb5de",
            "province":"北京市",
            "city":"北京市",
            "district":"东城区",
            "business":"",
            "cityid":"131",
            "tag":"地铁站",
            "address":"",
            "children":[
                
            ],
            "adcode":"110101"
        },
        {
            "name":"天安门广场-国旗",
            "location":{
                "lat":39.91328,
                "lng":116.403931
            },
            "uid":"4ae2adcf574bcd2b38221c66",
            "province":"北京市",
            "city":"北京市",
            "district":"东城区",
            "business":"",
            "cityid":"131",
            "tag":"旅游景点",
            "address":"北京市-东城区-天安门广场内",
            "children":[
                
            ],
            "adcode":"110101"
        },
        {
            "name":"天安门西-地铁站",
            "location":{
                "lat":39.913776,
                "lng":116.398036
            },
            "uid":"002975204d3b1e9b9968b4de",
            "province":"北京市",
            "city":"北京市",
            "district":"西城区",
            "business":"",
            "cityid":"131",
            "tag":"地铁站",
            "address":"",
            "children":[
                
            ],
            "adcode":"110102"
        },
        {
            "name":"天安门东地铁站-b口",
            "uid":"448961a899f372b7077ce838",
            "province":"",
            "city":"",
            "district":"",
            "business":"",
            "cityid":"131",
            "tag":"",
            "address":"北京市-东城区",
            "children":[
                
            ]
        },
        {
            "name":"天安门-入口",
            "location":{
                "lat":39.914939,
                "lng":116.404137
            },
            "uid":"fd975efc10193656734b879a",
            "province":"北京市",
            "city":"北京市",
            "district":"东城区",
            "business":"",
            "cityid":"131",
            "tag":"出入口",
            "address":"北京市-东城区-天安门内",
            "children":[
                
            ],
            "adcode":"110101"
        },
        {
            "name":"天安门广场东-公交车站",
            "location":{
                "lat":39.908018,
                "lng":116.405975
            },
            "uid":"bc3118720ad264138a36ee6f",
            "province":"北京市",
            "city":"北京市",
            "district":"东城区",
            "business":"",
            "cityid":"131",
            "tag":"公交站",
            "address":"",
            "children":[
                
            ],
            "adcode":"110101"
        },
        {
            "name":"天安门-城楼检票处(入口)",
            "location":{
                "lat":39.915739,
                "lng":116.403663
            },
            "uid":"f7a0d122f3307a767dc876f1",
            "province":"北京市",
            "city":"北京市",
            "district":"东城区",
            "business":"",
            "cityid":"131",
            "tag":"出入口",
            "address":"北京市-东城区-天安门内",
            "children":[
                
            ],
            "adcode":"110101"
        },
        {
            "name":"天安门东-公交车站",
            "location":{
                "lat":39.914198,
                "lng":116.408332
            },
            "uid":"947c13ba353f9123dbd891fb",
            "province":"北京市",
            "city":"北京市",
            "district":"东城区",
            "business":"",
            "cityid":"131",
            "tag":"公交站",
            "address":"",
            "children":[
                
            ],
            "adcode":"110101"
        }
    ]
}

最后更新: -

GET地点详情检索

GET地理编码