百度地图API SDK
2021-01-11 21:46 来源:icon图标制作
百度地图API SDK百度地图API SDK
内容(服务介绍)
普通IP定位
普通IP定位是一套以HTTP/HTTPS形式提供的轻量级定位接口,用户可以通过该服务,根据IP定位来获取大致位置。
目前该服务同时支持 IPv4 和 IPv6 来获取位置信息。
功能介绍
利用IP获取大致位置,调用API接口,返回请求参数中指定上网IP的大致位置信息(一般为城市级别),位置信息包括:经纬度、省、市等地址信息。
普通IP定位服务目前不支持海外场景。
如果请求参数中未指定上网IP,则默认返回当前服务请求来源的IP所对应的大致位置信息。
注意:该服务所返回的经纬度信息只是一个大概的位置,一般为城市中心点。
适用场景
适用于对定位精度要求不高的IP请求定位的应用。
如果您的应用为Android Native App,建议使用Android定位SDK,定位效果最佳,精度可达到10m,且无任何使用配额及并发量的限制。
内容(服务文档)
接口字段介绍
请求URL
?ak=您的AK&ip=您的IP&coor=bd09ll //HTTP协议
https://api.map.baidu.com/location/ip?ak=您的AK&ip=您的IP&coor=bd09ll //HTTPS协议
请求参数:
参数名称
参数含义
类型
备注
ip
用户上网的IP地址,请求中如果不出现或为空,会针对发来请求的IP进行定位。
如您需要通过IPv6来获取位置信息,请提交工单申请。
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
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来获取位置信息,请提交工单申请
内容(使用指南)
使用指南
1 注册成为百度用户
2 成为地图开放平台开发者
3 获取密钥(AK)
4 使用相关服务功能
服务使用限制
每一个开发者帐号每天使用普通IP定位服务的使用次数是有限的,即配额有限;
每一个开发者帐号在每分钟内使用普通IP定位服务的次数是有限的,即并发量有限;
同一个帐号下的HTTP/HTTPS请求、配额、并发共享;
服务相关配额及并发请访问开发者权益页面查看。
网站免责声明
本网站所提供的信息,只供参考之用。
本网站及其雇员一概毋须以任何方式就任何信息传递或传送的失误、不准确或错误对用户或任何其他人士负任何直接或间接的责任。
本网站在此声明,不承担用户或任何人士就使用或未能使用本网站所提供的信息或任何链接或项目所引致的任何直接、间接、附带、从属、特殊、惩罚性或惩戒性的损害赔偿(包括但不限于收益、预期利润的损失或失去的业务、未实现预期的节省)。
本网站所提供的信息,若在任何司法管辖地区供任何人士使用或分发给任何人士时会违反该司法管辖地区的法律或条例的规定或会导致本网站或其第三方代理人受限于该司法管辖地区内的任何监管规定时,则该等信息不宜在该司法管辖地区供该等任何人士使用或分发给该等任何人士。用户须自行保证不会受限于任何限制或禁止用户使用或分发本网站所提供信息的当地的规定。
本网站图片,文字之类版权申明,因为网站可以由注册用户自行上传图片或文字,本网站无法鉴别所上传图片或文字的知识版权,如果侵犯,请及时通知我们,本网站将在第一时间及时删除。
凡以任何方式登陆本网站或直接、间接使用本网站资料者,视为自愿接受本网站声明的约束。联系QQ515827934