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

文档全面上新

更科技的视觉体验,更高效的页面结构,快前往体验吧!

体验新版
服务介绍
服务文档
使用指南
常见问题
更新日志
普通IP定位

普通IP定位是一套以HTTP/HTTPS形式提供的轻量级定位接口,用户可以通过该服务,根据IP定位来获取大致位置。


目前该服务同时支持 IPv4 和 IPv6 来获取位置信息。

功能介绍

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

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

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

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

适用场景

适用于对定位精度要求不高的IP请求定位的应用。

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

接口字段介绍
请求URL
https://api.map.baidu.com/location/ip?ak=您的AK&ip=您的IP&coor=bd09ll //GET请求 

https://api.map.baidu.com/location/ip?ak=您的AK&ip=您的IP&coor=bd09ll //GET请求

请求参数:

参数名称 参数含义 类型 备注
ip
用户上网的IP地址,请求中如果不出现或为空,会针对发来请求的IP进行定位。
如您需要通过IPv6来获取位置信息,请提交工单申请。
string
可选
ak
开发者密钥,可在API控制台申请获得
string
必填
sn
若用户所用AK的校验方式为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
province 省份 string
point x 当前城市中心点经度 string
y 当前城市中心点纬度 string
status 结果状态返回码,请参考本章节后面的介绍 string
接口功能示例

返回结果示例:

{  
    address: "CN|北京|北京|None|CHINANET|1|None",    #详细地址信息  
    content:    #结构信息  
    {  
        address: "北京市",    #简要地址信息  
        address_detail:    #结构化地址信息  
        {  
            city: "北京市",    #城市  
            city_code: 131,    #百度城市代码  
            province: "北京市",    #省份      
        },  
        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 当前并发量已经超过约定并发配额,并且服务总并发量也已经超过设定的总并发配额,限制访问 并发控制超限,请控制并发量请联系我们
1001 没有IPv6地址访问的权限 如需通过IPv6来获取位置信息,请提交工单申请
使用指南
服务使用限制

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

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

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

服务相关配额及并发请访问开发者权益页面查看。

      注册成为百度地图开放平台的开发者后,即可成为未认证开发者,此时普通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

2020年1月10日

IPv6

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

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

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

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

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

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

全面支持IPv6
新增

通过IP获取经纬度、省、市等信息

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消