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

WEB 服务API

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

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

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

功能介绍

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

适用场景

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

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

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

请求头

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

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

string 必选
src

定位请求来源,厂商标 识,比如(baidu),开发者可自定义

string
必选
prod

产品线名称,比如(baiduwatch),开发者可自定义

string
必选
ver

申请服务版本号,目前只提供1.0服务

string
必选

trace

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

bool

必选


请求体:

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

移动端接入网络方式 可选值:

移动接入网络:0

wifi接入网络:1

仅gps坐标转换:2

默认值:无

int 必选
imei

手机imei号 默认值:无

此参数能够提高定位精度和准确度,且 定位不到时可依据此参数进行跟踪排 查,如没有则无法排查和跟踪问题。

string
必选
smac

手机mac码 默认值:无

此参数能够提高定位精度和准确度,且定位不到时可依据此参数进行跟踪排查,如没有则无法排查和跟踪问题。

string
非必选,但建议填写
clientip

移动网关IP 默认值:无

此参数能够提高定位精度和准确度,且定位不到时可依据此参数进行跟踪排查,如没有则无法排查和跟踪问题。

string
非必选,但建议填写

cdma

是否为cdma。

非cdma:0; cdma:1 默认值为:0

int

accesstype=0时,必选

imsi

移动用户识别码 默认值:无

此参数能够提高定位精度和准确度,且定位不到时可依据此参数进行跟踪排查,如没有则无法排查和跟踪问题。

string

非必选,但建 议填写


gps

手机GPS数据

取值规则: 经度|纬度|半径

string

accesstype=2时,必选

network

无线网络类型 GSM/GPRS/EDGE/HSUPA/HSDPA/WCDMA (注意大写)

string

accesstype=0时,必选

tel

手机号码

string

非必选

bts

基站信息 基站信息,非CDMA格式为:mcc, mnc,lac,cellid,signal;CDMA格式为:sid,nid,bid,lon,lat,signal

其中lon,lat可为空,格式为:sid,nid,bid,,,signal

string

accesstype=0时,必选

nearbts

周边基站信息 基站信息1|基站信息2|基站信息3….

string

非必选

mmac

已连热点mac信息 mac,signal,ssid。 如:f0:7d:68:9e:7d:18,-41,TPLink 非必选,但强烈建议填写

string

非必选


macs

WI-FI列表中mac信息 单mac信息同mmac,mac之间使用“|”分隔。 必须填写 2 个及 2 个以上,30 个 以内的方可正常定位。

请不要包含移动WI-FI信息

string

accesstype=1时,必选

coor

指定坐标系(GCJ02|BD09LL)注意大写

默认返回BD09LL坐标系。

string

非必选

output

返回数据格式类型(注意大写) 可选值:JSON, XML 默认值:JSON 一期只支持JSON

string

非必选

ctime

客户端时间戳

string

必选

need_rgc

返回地址信息,默认不返回

Y : 返回rgc结果 N : 不返回rgc结果

string

非必选


特别说明: 为了尽可能地保证您定位结果的精确性以及问题追踪,除了必须填写的参数外,其他可以获得的参数尽可能的传入。 例如:WI-FI接入网络的情况下,也可以传入其对应的基站信息;而在移动接入网络的情况下,也可传入 WI-FI列表中 mac 信息(macs)。

返回结果(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

完整请求可包含多条请求数据,示例如下:

{
	"ver": "1.0",
	"trace": false,
	"prod": "test_loc_api",
	"src": "baidu_loc_api",
    "key": "XXXXXXXXXXXXXXXXXXXXXXXXXXX",
	"body": [{
			"bts": "460,0,4189,8869,-63",
			"output": "JSON",
			"accesstype": 0,			           

"macs":"70:ba:ef:d0:87:91,-42,|70:ba:ef:d1:0e:01,-45,|70:ba:ef:cc:98:11,-56,|dc:fe:18:c9:94:ce,-87,|58:60:5f:68:d8:30,-89,|94:d9:b3:cf:a2:db,-91,|30:fc:68:ac:c6:ae,-91,|c8:3a:35:32:48:c8,-94,",
			"imei": "xxxxxxxxxxxxxxx",
			"ctime": "1551178833",			
"nearbts":"460,0,4189,33989,-81|460,0,4189,8868,-83|460,0,4189,33988,-84|460,0,4189,239,-86|460,0,4189,32659,-98|460,0,4189,8867,-99",
			"cdma": 0,
			"need_rgc": "Y",
			"network": "GPRS"
		},
		{
			"accesstype": 0,
			"imei": "xxxxxxxxxxxxxxx",
			"clientip": "232.111.11.240",
			"cdma": 0,
			"imsi": "xxxxxxxxxxxxxxx",
			"network": "GPRS",
			"bts": "510,11,25182,40081,-83",
			"macs": "e0:36:76:e8:11:78,-18,1",
			"coor": "bd09ll",
			"output": "JSON",
			"ctime": "1551178833",
			"need_rgc": "Y"
		},
		{
			"accesstype": 0,
			"imei": "xxxxxxxxxxxxxxx",
			"cdma": 0,
			"imsi": "xxxxxxxxxxxxxxx",
			"network": "GSM",
			"bts": "460,0,4163,21297934,-124",
			"nearbts": "460,0,-1,-1,13|460,0,-1,-1,29",

"macs":"C8:E7:D8:33:B4:7C,-52,73cun|8C:A6:DF:DF:4B:14,-54,nolimit|E4:6F:13:CC:15:41,-57,weizhiweikeyong|E4:6F:13:CC:15:40,-64,WZWIT|66:14:4B:55:C8:48,-69,CMCC|54:B1:21:A6:81:D5,-73,HUAWEI-E5573-81D5|02:6B:E7:92:B1:73,-76,VANS|20:F4:1B:B6:9F:46,-78,ydnc",
			"coor": "GCJ02",
			"output": "JSON",
			"ctime": "1551178833",
			"need_rgc": "Y"
		}
	]
}

   


完整响应示例如下:

{

    "errcode": 0,
    "msg": "Query success.",
    "body": [
        {
            "type": 2,
            "location": "116.298457,39.848625",
            "radius": 41,
            "country": "中国",
            "province": "北京市",
            "city": "北京市",
            "citycode": "131",
            "district": "丰台区",
            "road": "丰台南路44号",
            "ctime": "1551178833",
            "indoor": "1",
            "error": 0
        },
        {
            "type": 4,
            "location": "107.614218,-6.941022",
            "radius": 111,
            "country": "Indonesia",
            "province": "Jawa Barat",
            "city": "Bandung City",
            "citycode": "34544",
            "district": "",
            "road": "Jalan Sriwijaya",
            "ctime": "1551178833",
            "indoor": "0",
            "error": 0
        },
        {
            "type": 2,
            "location": "116.352743,39.941695",
            "radius": 15,
            "country": "中国",
            "province": "北京市",
            "city": "北京市",
            "citycode": "131",
            "district": "西城区",
            "road": "西直门外大街1号院-3号",
            "ctime": "1551178833",
            "bldg": "bjxcqkdmall",
            "bldgid": "1266783613064577023",
            "bldgname": "凯德MALL(西直门嘉茂店)",
            "floor": "f4",
            "indoor": "1",
            "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

使用PostMan测试接口可参考下图: hardware-postman.png


使用指南
服务使用限制

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

如果您的应用为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

2018年11月10日

V1.8

2019年2月28日

V1.9

智能硬件定位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)

智能硬件定位API服务V1.8上线
优化

优化线上问题


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

新增postman说明

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消