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

URL

请求方式

https://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

请求方式

https://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 名称 (非必返回)