浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

WEB 服务API

百度地图Web服务API为开发者提供http/https接口,即开发者通过http/https形式发起检索请求,获取返回json或xml格式的检索数据。用户可以基于此开发JavaScript、C#、C++、Java等语言的地图应用。

服务介绍
服务接口文档
使用指南
常见问题
更新日志
功能介绍
利用IP获取大致位置

调用API接口,返回请求参数中指定上网IP的大致位置信息(一般为城市级别),位置信息包括:经纬度、省、市等地址信息。

普通IP定位服务目前不支持海外场景。

如果请求参数中未指定上网IP,则默认返回当前服务请求来源的IP所对应的大致位置信息。

注意:该服务所返回的经纬度信息只是一个大概的位置,一般为城市中心点。

接口字段介绍
请求URL
http://api.map.baidu.com/location/ip //HTTP协议 

https://api.map.baidu.com/location/ip //HTTPS协议

请求参数:

参数名称 参数含义 类型 备注
ip
用户上网的IP地址,请求中如果不出现、或为空,会针对发来请求的IP进行定位。
string
可选
ak
开发者密钥,可在API控制台申请获得。
string
可选
sn
若用户所用AK的校验方式为SN校验时该参数必填(什么是SN校验?)。其他AK校验方式的可不填写。
string
可选
coor
设置返回位置信息中,经纬度的坐标类型,分别如下:
coor不出现、或为空:百度墨卡托坐标,即百度米制坐标;
coor = bd09ll:百度经纬度坐标,在国测局坐标基础之上二次加密而来;
coor = gcj02:国测局02坐标,在原始GPS坐标基础上,按照国家测绘行业统一要求,加密后的坐标;
注:百度地图的坐标类型为bd09ll,如果结合百度地图使用,请注意坐标选择。
string
可选

返回结果(JSON格式):

结果字段 字段含义 类型
address 详细地址信息。 string
content address 简要地址信息。 string
address_detail city 城市。 string
city_code 百度城市代码。 string
district 区县。 string
province 省份。 string
street 街道。 string
street_number 门牌号。 string
point x 当前城市中心点经度。 string
y 当前城市中心点纬度。 string
status 结果状态返回码,请参考本章节后面的介绍。 string
接口功能示例

服务示例:

参数名称 参数含义 类型 备注
ip 用户上网的IP地址,请求中如果不出现、或为空,会针对发来请求的IP进行定位。 string 可选
ak 开发者密钥,可在API控制台申请获得。 string 必选
coor
设置返回位置信息中,经纬度的坐标类型,分别如下:
coor不出现、或为空:百度墨卡托坐标,即百度米制坐标;
coor = bd09ll:百度经纬度坐标,在国测局坐标基础之上二次加密而来;
coor = gcj02:国测局02坐标,在原始GPS坐标基础上,按照国家测绘行业统一要求,加密后的坐标;
注:百度地图的坐标类型为bd09ll,如果结合百度地图使用,请注意坐标选择。
string 可选
请求 http://api.map.baidu.com/location/ip?ip=xx.xx.xx.xx&ak=您的AK&coor=bd09ll

https://api.map.baidu.com/location/ip?ip=xx.xx.xx.xx&ak=您的AK&coor=bd09ll

返回结果示例:

{  
    address: "CN|北京|北京|None|CHINANET|1|None",    #详细地址信息  
    content:    #结构信息  
    {  
        address: "北京市",    #简要地址信息  
        address_detail:    #结构化地址信息  
        {  
            city: "北京市",    #城市  
            city_code: 131,    #百度城市代码  
            district: "",    #区县  
            province: "北京市",    #省份  
            street: "",    #街道  
            street_number: ""    #门牌号  
        },  
        point:    #当前城市中心点  
        {  
            x: "116.39564504",    #当前城市中心点经度
            y: "39.92998578"    #当前城市中心点纬度
        }  
    },  
    status: 0    #结果状态返回码  
}
接口错误码
状态码 定义 注释
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 当前并发量已经超过约定并发配额,并且服务总并发量也已经超过设定的总并发配额,限制访问 并发控制超限,请控制并发量请联系我们
使用方法
服务配额

每一个开发者帐号每天使用普通IP定位服务的使用次数是有限的,即配额有限。

每一个开发者帐号在每分钟内使用普通IP定位服务的次数是有限的,即并发量有限。

同一个帐号下的HTTP/HTTPS请求,配额、并发共享。

配额及默认并发量说明如下

分类 未认证 个人认证 企业认证
日配额(次) 100,000 300,000 3,000,000
分钟并发数(次/分钟) 6,000 12,000 30,000


注册成为百度地图开放平台的开发者后,即可成为未认证开发者,此时普通IP定位API服务可正常使用,只是每天所能够调用请求的次数和并发量较低。可通过开发者认证,成为个人或企业认证开发者,服务配额及并发量会大幅度提升。

普通IP定位效果一般,只能针对IP返回大致位置信息,适用于对位置精度要求不高的应用。

如果您的应用为Android Native App,建议使用Android定位SDK,定位效果最佳,精度可达到10m,且无任何使用配额及并发量的限制。


1、普通IP定位API的定位精度怎样?

普通IP定位API只能够根据开发者输入的IP,返回大致的位置信息,一般是城市级别的。结果中的经纬度坐标,一般为当前IP所在城市中心点的坐标。

2、普通IP定位API的使用配额/并发满了要怎么办?

普通IP定位API服务与其他API服务一样,具有每天使用配额和并发次数的限制。如果您的使用配额或并发不能满足业务使用需求,可以通过认证个人/企业开发者的方式,提升配额。如果您已经是企业认证开发者,配额/并发依然不够使用,可在API控制台,我的服务中申请做进一步提升。

3、如何能够使用精度更高的定位服务?

如果您是Android或iOS移动应用的开发者,我们推荐您使用Android/iOS端定位SDK产品。定位SDK产品是专门针对移动端Native App设计的,具有定位成功率高、速度快、精度高、流量小的特点。此外,SDK产品没有使用配额限制。


2013年7月5日

v1.0

2016年9月26日

v2.0

2017年4月12日

v3.0

普通IP定位API服务v1.0上线
新增

返回值支持返回百度经纬度坐标(默认返回是墨卡托坐标)。

普通IP定位API服务v2.0上线
新增

普通IP定位API服务,全面支持HTTPS协议类型访问。

普通IP定位API服务v3.0上线
新增

普通IP定位服务,支持返回GCJ02类型城市中心点坐标。