智能硬件定位

POST

/locapi/v2

接口错误码

状态码	错误描述
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校验失败)
711	APP SN校验失败。当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败。可考虑在控制台-我的应用中将AK的请求校验方式改为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

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://api.map.baidu.com/locapi/v2?ak=&sn=' \
--header 'key;' \
--header 'src;' \
--header 'prod;' \
--header 'ver;' \
--header 'trace;' \
--data-urlencode 'accesstype=' \
--data-urlencode 'ctime='

响应示例

{
  "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
    }
  ]
}

请求参数

Query 参数

string

必需

开发者的访问密钥，必填项。v2之前该属性为key。申请秘钥

默认值:

string

可选

可选，若开发者所用AK的校验方式为SN校验时该参数必须。

默认值:

Header 参数

key

string

必需

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

src

string

必需

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

prod

string

必需

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

ver

string

必需

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

trace

string

必需

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

Body 参数application/x-www-form-urlencoded

accesstype

integer

必需

移动端接入网络方式可选值：移动接入网络：0 wifi接入网络：1 仅gps坐标转换：2 默认值：无

smac

string

可选

手机mac码默认值：无此参数能够提高定位精度和准确度，且定位不到时可依据此参数进行跟踪排查，如没有则无法排查和跟踪问题。

clientip

string

可选

移动网关IP 默认值：无此参数能够提高定位精度和准确度，且定位不到时可依据此参数进行跟踪排查，如没有则无法排查和跟踪问题。

cdma

string

可选

是否为cdma。非cdma：0; cdma：1 默认值为：0；accesstype=0时，必选

imsi

string

可选

移动用户识别码默认值：无此参数能够提高定位精度和准确度，且定位不到时可依据此参数进行跟踪排查，如没有则无法排查和跟踪问题；非必选，但建议填写

gps

string

可选

手机GPS数据取值规则：经度|纬度|半径；accesstype=2时，必选

network

string

可选

无线网络类型 GSM/GPRS/EDGE/HSUPA/HSDPA/WCDMA (注意大写)；accesstype=0时，必选

tel

string

手机号码

可选

bts

string

可选

基站信息，非CDMA格式为：mcc, mnc,lac,cellid,signal；其中lac，cellid必须填写，signal如无法获取请填写50，前两位mcc, mnc 如无法获取，请填写-1 CDMA格式为：sid,nid,bid,lon,lat,signal 其中lon,lat可为空，格式为：sid,nid,bid,,,signal 为保证定位效果，请尽量全部填写；accesstype=0时，必选

nearbts

string

可选

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

mmac

string

可选

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

macs

string

可选

WI-FI列表中mac信息单mac信息同mmac，mac之间使用“|”分隔。必须填写 2 个及 2 个以上,30 个以内的方可正常定位。请不要包含移动WI-FI信息；accesstype=1时，必选

coor

string

可选

可指定坐标系(GCJ02|BD09LL)，注意大写。国内（包含港澳台）默认返回BD09LL坐标系。国外不论填写任何坐标系类型，均返回WGS84坐标系。

output

string

可选

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

ctime

string

客户端时间戳

必需

need_rgc

string

可选

返回地址信息，默认不返回 Y : 返回rgc结果 N : 不返回rgc结果

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

msg

string

必需

body

array [object {16}]

必需

type

integer

必需

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

location

string

必需

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

radius

integer

必需

定位精度半径，单位:米

country

string

国家

必需

province

string

省

必需

city

string

市

必需

citycode

string

城市编码

必需

district

string

县区

必需

road

string

道路名

必需

ctime

string

必需

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

indoor

string

必需

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

error

integer

必需

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

bldg

string

建筑物简称

可选

bldgid

string

建筑物ID

可选

bldgname

string

建筑物

可选

floor

string

楼层

可选

修改于 2022-08-22 02:40:10

服务文档

概述