智能硬件定位 最后更新时间: 2024年02月26日

URL

http://apilocate.amap.com/position?parameters

请求方式

GET

参数名

含义

规则说明

是否必须

缺省值

key 

请求服务权限标识

用户在高德地图官网 申请 Web 服务 API 类型Key

必填 

无 

accesstype 

移动端接入网络方式 

可选值： 

移动接入网络：0 

wifi 接入网络：1 

必填 

无 

imei 

手机 imei 号 

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

必填 

无 

idfa 

ios 手机的 idfa 

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

与 imei 必填一个 

无 

smac 

手机 mac 码 

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

非必填，但建议填写 

无 

serverip 

设备接入基站时对应的网关 IP 

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

非必填，但建议填写 

无 

cdma 

是否为 cdma 

是否为 cdma：

非 cdma：0 

是 cdma：1  

accesstype=0

时，必填 

0 

imsi 

移动用户识别码 

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

非必填，但建议填写 

无 

network 

无线网络类型 

GSM/GPRS/EDGE/HSUPA/HSDPA/WCDMA 

accesstype=0

时，必填 

tel 

手机号码 

非必填 

无 

bts 

接入基站信息 

接入基站信息，详见：表 1-2 内部参数说明 

非 CDMA 格式为：mcc,mnc,lac,cellid,signal 

CDMA 格式为：sid,nid,bid,lon,lat,signal

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

accesstype=0

时，必填 

无 

nearbts 

周边基站信息（不含接入基站信息） 

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

非必填 

无 

mmac 

已连热点 mac 信息 

mac,signal,ssid

如：

mac：f0:7d:68:9e:7d:18

signal：-41

ssid：TPLink 

非必填，但强烈建议填写 

无 

macs 

wifi 列表中 mac 信息 

单 mac 信息同 mmac，mac 之间使用“|” 分隔。必须填写 2 个及 2 个以上,30 个以内的方可正常定位。请不要包含移动 wifi 信息 

accesstype=1

时，必填 

无 

output 

返回数据格式类型 

可选值：JSON | XML 

可选 

JSON

参数名称 

参数含义 

是否必填 

mcc 

移动用户所属国家代码，默认值为 460 

cdma=0 时，必填 

mnc 

移动网号, 中国移动：0；中国联通：1 

cdma=0 时，必填 

lac 

位置区域码, 取值范围：0-65535 

cdma=0 时，必填 

cellid 

基站小区编号,取值范围：0-65535，0-268435455

其中 0/65535/268435455 取值不可使用

小区编号大于 65535 时为 3G 基站 

cdma=0 时，必填 

signal 

信号强度, 取值范围：0 到-113dbm. 

(如获得信号强度为正数，则请按照以下公式进行转换：获得的正信号强度 * 2 – 113) 

cdma=0 时，必填 

sid 

cdma 系统识别码 

cdma=1 时，必填 

nid 

cdma 网络识别码 

cdma=1 时，必填 

bid 

cdma 小区唯一识别码 

cdma=1 时，必填 

lon 

cdma 经度值, 手机平台接口读出的数值 

可选 

lat 

cdma 纬度值, 手机平台接口读出的数值 

可选 

mac 

mac 地址，例如：00:0f:e2:4e:aa:3e 

accesstype=1 时，必填 

ssid 

无线网络名称 

accesstype=1 时，必填 

名称

含义

规则说明

status

返回结果状态值

值为 0 或 1，0 表示失败；1 表示成功

info

返回状态说明

返回状态说明，status 为 0 时，info 返回错误原因，否则返回“OK”

result

定位结果列表

type

定位类型

0：没有得到定位结果；

其他数字为：正常获取定位结果

imei

手机 imei 号

location

定位经纬度

radius

定位精度半径，单位：米

desc

位置描述

country

国家

province

省份

city

城市

citycode

城市编码

adcode

区域编码

road

道路名

poi

定位附近的 poi 名称

Info 返回值 

状态描述 

OK 

正常 

INVALID_USER_KEY 

用户 key 非法或过期 

SERVICE_NOT_EXIST 

请求服务不存在 

SERVICE_RESPONSE_ERROR 

请求服务响应错误 

INSUFFICIENT_PRIVILEGES 

无权限访问此服务 

OVER_QUOTA 

请求超出配额 

INVALID_PARAMS 

请求参数非法 

UNKNOWN_ERROR 

未知错误 

URL

http://restapi.amap.com/v5/position/IoT?parameters

请求方式

POST

参数名

含义

规则说明

是否必填

缺省值

key

请求服务权限标识

用户在高德地图官网 申请 Web 服务 API 类型 Key

是

无

diu

设备唯一编号

用于问题排查，建议填充 imei、IDFA 等唯一标识，未填则后续无法排查问题

否

无

accesstype

移动端接入网络方式

可选值：

0-未知

1-移动网络

2-wifi

是

无

cdma

手机卡是否为 CDMA 卡

可选值：非 cdma-0，cdma-1

accesstype=1时必填 

无

network

无线网络类型 

GSM/GPRS/EDGE/HSUPA/HSDPA/WCDMA/NR

GSM

bts

接入基站信息

非 CDMA 格式为：mcc,mnc,lac,cellid,signal,cage

CDMA 格式为：

sid,nid,bid,lon,lat,signal,cage

lon,lat 为空时，格式为：sid,nid,bid,,,signal,cage

基站新鲜度字段（cage）说明：单位为秒，表示信号不变持续的时间。新鲜度值越大（数据越陈旧），偏离实际位置可能越大。默认为 0。

无

nearbts

周边基站信息（不含接入基站） 

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

否

无

historybts

历史基站信息

历史定位基站信息，用于辅助定位。格式与周边基站信息相同。

否

无

mmac

已连接 WiFi 信息

格式为：mac,signal,ssid,fresh

如：

mac：f0:7d:68:9e:7d:18

signal：-41

ssid：TPLink

fresh：0

WiFi 新鲜度字段（fresh）说明：单位为：秒，表示信号不变持续的时间。新鲜度值越大（数据越陈旧），偏离实际位置可能越大。默认为 0。

accesstype=2时必填 

无

macs

WiFi 列表中的 WiFi 信息

单 mac 信息同 mmac，mac 之间使用“|” 分隔。必须填写 2 个及 2 个以上,30 个以内的方可正常定位。请不要包含移动 wifi 信息 

否

无

show_fields

逆地理编码结果开关

否

无

名称

类型

说明

status

String

本次 API 访问状态，如果成功返回 1，如果失败返回 0。

info

String

访问状态值的说明，如果成功返回"ok"，失败返回错误原因，具体见 错误码说明。

infocode

String

返回状态说明,10000 代表正确,详情参阅 info 状态表

position

Object

返回的定位结果列表

location

String

定位结果坐标，如：116.473168,39.993015

radius

int

定位精度半径，单位：米

注意以下字段如果需要返回，需要通过“show_fields”进行参数类设置。

show_fields

String

可选差异化结果返回

formatted_address

String

结构化地址信息

addressComponent

Object

地址元素列表

country

String

国

province

String

省

city

String

市

district

String

区

citycode

String

城市编码

adcode

String

区域编码

street

String

附近街道名称

road

String

周边道路名称

poi

String

周边 POI 名称

服务

个人认证开发者 

企业开发者 

日调用超量封停

（次/日）

QPS

（次/秒）

日调用超量封停

（次/日）

QPS

（次/秒）

智能硬件定位

不开放

3000000

30

智能硬件定位 2.0

不开放

300000

30