接口文档

通信协议

目前支持HTTP、HTTPS 两种通讯方式

请求方法

请求接口:

GET http://lbs.baidubce.com

公共请求头

头域 类型 说明
Content-Type String 总是application/json; harset=utf-8
x-bce-request-id uuid 请求id 36位uuid(非必须)
x-bce-date String UTC时间 格式%YYYY-%mm-%ddT%HH:%MM:%SSZ eg 2018-02-22T09:47:52Z
x-app-id uuid 应用ID 在console上可见
Host String Http HEADER必须项
Authorization String 百度智能云统一认证字符串详情

公共响应头

所有的请求响应,需要包含如下的header信息

头域 类型 说明
x-bce-request-id uuid 对应请求的requestId
Content-Type String 总是application/json;charset=utf-8

接口定义

普通IP定位

请求示例

HTTP_METHOD URI 说明
GET /location/ip 调用请求

请求例子:

curl -H "Content-Type:application/json" -H "x-bce-user-id: xxx..." -H "x-lbs-app-id: xxx...." -H "x-bce-date:2018-02-22T09:47:52Z" -H "Authorization:bce-auth-v1/xxx..." http://lbs.baidubce.com/location/ip?ip=xxx.xxx.xxx.xxx&coor=bd09ll

请求参数

参数名称 含义 类型 备注
ip 用户上网的IP地址,请求中如果不出现或为空,会针对发来请求的IP进行定位 string 可选
coor 设置返回位置信息中,经纬度的坐标类型,分别如下:
coor不出现、或为空:百度墨卡托坐标,即百度米制坐标
coor = bd09ll:百度经纬度坐标,在国测局坐标基础之上二次加密而来
coor = gcj02:国测局02坐标,在原始GPS坐标基础上,按照国家测绘行业统一要求,加密后的坐标

注意:百度地图的坐标类型为bd09ll,如果结合百度地图使用,请注意坐标选择
string 可选

返回结果

返回结果参数(Json格式)

结果字段 含义 类型
address 详细地址信息 string
content 结构信息 object
+ address 简要地址信息 string
+ address_detail 结构化地址信息 object
+ + city 城市 string
+ + city_code 百度城市代码 string
+ + district 区县 string
+ + province 省份 string
+ + street 街道 string
+ + street_number 门牌号 string
+ point 当前城市中心点 object
+ + x 当前城市中心点经度 string
+ + y 当前城市中心点纬度 string
status 结果状态返回码,请参考状态码说明 string

状态码说明

状态码 定义 注释
0 正常
1 服务器内部错误 该服务响应超时或系统内部错误
10 上传内容超过8M Post上传数据不能超过8M
101 AK参数不存在 请求消息没有携带AK参数
102 Mcode参数不存在,mobile类型mcode参数必需 对于Mobile类型的应用请求需要携带mcode参数,该错误码代表服务器没有解析到mcode
200 APP不存在,AK有误请检查再重试 根据请求的AK,找不到对应的APP
201 APP被用户自己禁用,请在控制台解禁
202 APP被管理员删除 恶意APP被管理员删除
203 APP类型错误 当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone(类型22)及Browser(类型3),除此之外的其他类型被认为是APP类型错误
210 APP IP校验失败 在申请Server类型应用的时候选择IP校验,需要填写IP白名单,如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败
211 APP SN校验失败 SERVER类型APP有两种校验方式:IP校验和SN校验,当用户请求的SN和服务端计算出来的SN不相等的时候,提示SN校验失败
220 APP Referer校验失败 浏览器类型的APP会校验referer字段是否存在,且在referer白名单里面,否则返回该错误码
230 APP Mcode码校验失败 服务器能解析到mcode,但和数据库中不一致,请携带正确的mcode
240 APP 服务被禁用 用户在API控制台中创建或设置某APP的时候禁用了某项服务
250 用户不存在 根据请求的user_id, 数据库中找不到该用户的信息,请携带正确的user_id
251 用户被自己删除 该用户处于未激活状态
252 用户被管理员删除 恶意用户被加入黑名单
260 服务不存在 服务器解析不到用户请求的服务名称
261 服务被禁用 该服务已下线
301 永久配额超限,限制访问 配额超限
302 天配额超限,限制访问 配额超限
401 当前并发量已经超过约定并发配额,限制访问 并发控制超限
402 当前并发量已经超过约定并发配额,并且服务总并发量也已经超过设定的总并发配额,限制访问 并发控制超限