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

WEB 服务API

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

服务介绍
服务文档
使用指南
常见问题
更新日志
智能硬件定位

可以通过蓝牙、WI-FI等获取用户定位数据。

功能介绍

利用蓝牙、WIFI等信息,传给服务端进行处理,获取定位信息,完成地图、路线规划、轨迹等功能。

适用场景

适用于室内、室外多种定位场景,覆盖智能可穿戴设备、车载设备等。(目前该服务只针对百度深度合作用户开放)

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

接口字段介绍
请求URL
https://api.map.baidu.com/locapi/v2 

请求参数:

参数名称 参数含义 类型 备注
key

用户唯一标识,用户可在API控制台申请,应用类型建议选择服务端

string 必选
src

定位请求来源,厂商标 识,比如(baidu)

string
必选
prod

产品线名称(baiduwatch)

string
必选
ver

申请服务版本号

string
必选

trace

是否开启trace,若为true,则将定位记录 到鹰眼(暂不开通)

bool

必选

返回结果(JSON格式):

结果字段 字段含义 类型

type

定位类型,0:没有得到定位结果;1:gps 定位结果;2:wifi定位结果;3:混合定位 结果;4:基站定位结果;5:其他--

int
location

定位经纬度(经度,纬度)

string

radius

定位精度半径,单位:米

int

desc

位置描述

string

country

国家 string

province

string

city

string

citycode

城市编码

string

district

县区

string

road

道路名

string

ctime

客户端请求时间戳,批量请求时用于匹配 服务端响应和客户端请求

string

bldg

建筑物简称

string
bldgid 建筑物ID string

bldgname

建筑物

string

floor

楼层

string

indoor

是否室内:0:室外 1:室内

string

error

定位是否成功 0: 成功 -1:失败

int

接口功能示例

服务示例:

参数名称 参数含义 类型 备注
key

用户唯一标识,用户可在API控制台申请,应用类型建议选择服务端

string 必选
src

请求来源(厂商标识)

string 必选
prod
产品线
string 必选
ver
版本
string
必选
trace
是否开启trace,若为true,则将定位记录 到鹰眼(暂不开通)

bool

必选
请求

http://api.map.baidu.com/locapi/v2?key=您的AK&src=XXX&prod=XXX&ver=XXX&trace=false

返回结果示例:

{
   type: 2,
   location: "123.45,34.56", 
   radius: 1000,
   desc: "xxx",
   country: "PRC", 
   province: "beijing", 
   city: "beijing", 
   citycode: 315,
   district: XXX,
   road: "xxx road", 
   ctime: "1234567890", 
   bldg: "gzhua",
   bldgid: "123",
   bldgname: "XXX商场",
   floor: "b2", 
   indoor: "0", 
   error:0
}
接口错误码
状态码 错误描述
0 正常
101 Missing field : body (size should > 0 && < 3)
102 Request is empty
103 参数错误,错误详情请见“msg”字段
104 Unexpected err, please contact with us
601 Failed to authenticate for lack of AK
700 Failed to authenticate for invaid AK : ${key}(key校验失败)
710 Failed to authenticate for invaid IP : ${ip} (服务端IP校验失败)
740 Failed to authenticate for api loc is forbidden.(服务被禁用,一般不会出现)
752 Failed to authenticate for bad user.(非法用户)
760 Failed to authenticate for servive is not exist(服务不存在,一般不会出现)
761 Failed to authenticate for servive is off the assembly line(服务已下线,一般不会出现)
801 Failed to authenticate for exceeding total quota(总用量超限,一般不会出现)
802 Failed to authenticate for exceeding daily quota(${quota_num}) (日用量超限)
901 Failed to authenticate for exceeding concurrency(${min_quota}) (分钟并发超限)
902 Failed to authenticate for exceeding concurrency(${min_quota}) (日用量与分钟并发均超限)
其他500+错误 Failed to authenticate for unexpected error, please contact with us
750 Failed to authenticate for user is not exist
751 Failed to authenticate for user is deleted by yourself
使用指南
服务使用限制

每一个开发者帐号只有申请权限后才可使用该服务;
服务相关配额及并发请访问开发者权益页面查看。

如果您的应用为Android Native App,建议使用Android定位SDK,定位效果相当、且无任何使用配额及并发量的限制。


1、怎样才可以使用智能硬件定位API?

您可以在控制台申请权限后使用该服务。


2、智能硬件定位API的使用配额/并发满了要怎么办?

智能硬件定位API服务与其他API服务一样,具有每天使用配额和并发次数的限制。您可以在控制台申请权限后提升配额及并发量。


3、智能硬件定位API和定位SDK有什么区别?

智能硬件API适用于智能硬件可穿戴设备、车载等完成地图、轨迹、路线规划等功能,目前有一定的配额和并发次数限制,需要您在控制台申请权限才可以使用。 如果您是Android或iOS移动应用的开发者,我们推荐您使用Android/iOS端定位SDK产品。定位SDK产品是专门针对移动端Native App设计的,具有定位成功率高、速度快、精度高、流量小的特点。此外,SDK产品没有使用配额限制。


2016年3月25日

v1.0

2016年7月6日

V1.1

2016年11月2日

V1.2

2018年5月8日

V1.3

2018年5月18日

V1.4

2018年6月7日

V1.5

2018年6月19日

V1.6

2018年7月9日

V1.7

智能硬件定位API服务V1.0上线
新增

文档创建

智能硬件定位API服务V1.1上线
新增

响应体中新增ctime,用于批量请求中匹配请求体

智能硬件定位API服务V1.2上线
新增

补充AK申请相关流程

智能硬件定位API服务V1.3上线
新增

修正部分功能描述

智能硬件定位API服务V1.4上线
新增

域名迁移

智能硬件定位API服务V1.5上线
新增

增加响应字段 bldg(建筑物)、floor(楼层)、indoor(室内外)

智能硬件定位API服务V1.6上线
新增

增加响应字段bldgname(建筑物中文名称)

智能硬件定位API服务V1.7上线
新增

增加响应字段bldgid(建筑物对应id)