导航|地址|刷新
智能硬件定位-高级 API 文档-开发指南-Web服务 API | 高德地图AP…












控制台

去认证企业


登录注册









退出


我的消息

云图市场

应用管理

GeoHUB




产品介绍

产品介绍高德开放平台产品介绍 查看全部文档

搜索定位


鸿蒙星河版定位SDK HOT鸿蒙星河版定位SDK

搜索 HOT位置、周边、行政区、ID等查询接口 API JS Android iOS

定位 HOT基于LBS的定位服务 API Android iOS

地理/逆地理编码 位置名称与经纬度之间转换服务 API JS Android iOS

地理围栏 虚拟空间围栏服务 API Android iOS

天气查询 查询目标区域当前/未来天气

智能硬件定位 通过基站、Wifi获取位置信息




路线导航


鸿蒙星河版导航SDK NEW鸿蒙星河版导航SDK

导航 HOT轻松地在APP中加入导航能力 Android iOS

路线规划 HOT提供步行、驾车等规划能力 API JS Android iOS

猎鹰服务 提供专业轨迹管理服务 API Android iOS

货车路径规划 专业的货车路径规划服务 API Android iOS

智能调度引擎 智能外勤调度，提升效益

物流服务 提供智慧物流API服务接口

公交信息查询 查询公交信息

交通路况查询 查询交通态势情况

高级路径规划 高级路径规划等能力




地图产品


鸿蒙星河版地图SDK HOT鸿蒙星河版-轻量地图SDK

动态地图 HOT动态地图展示、配置 API JS Android iOS HarmonyOS

3D地图 HOT3D动态地图展示、配置

地铁图 简单易用的移动端地铁线路图开发接口 JS Android iOS

静态地图 灵活地将高德地图迁入应用网页

3D地形图 卫星地形图还原真实地形地貌




高级地图工具


世界地图 NEW

自定义地图

地图数据可视化 (LOCA)

地图数据中心 (GeoHUB)

坐标拾取器

高德地图URI Web

高德地图URI APP

三维模型转换

微信小程序插件

地图Flutter插件

地图名片




高德地图小程序


地图小程序

客户管理

员工管理

送货提效

地图小程序API




空间智能开放平台


空间智能开放平台 NEW用真实空间信息解答业务问题






解决方案

解决方案提供各行业LBS解决方案


空间智能 NEW提供LBS领域的Agent解决方案

智能手表 NEW提供智能守护与运动出行解决方案

智能眼镜 NEW智能眼镜实时导航及智慧出行解决方案

世界地图 NEW面向开发者提供全球范围内LBS服务

智能两轮车 NEW合规精确的两轮车场景导航

手机银行 NEW提供手机银行APP地图应用





网格化营销 NEW提供银行网格化营销场景应用

智慧交通 优化交通资源配置，赋能智慧交通系统

出行 提供网约车等出行场景解决方案

O2O 到店、到家等多种O2O业务解决方案

上门服务调度 提供上门业务调度解决方案





三农场景可视化 NEW提供乡村振兴三农场景应用

社交 社交应用位置服务解决方案

运动 运动类应用解决方案

智能硬件 智能硬件LBS解决方案

零售铺货 零售快消行业，渠道铺货解决方案





智慧物流 针对物流行业提供解决方案

电商 电商物流行业解决方案

地址服务 综合地址服务，满足客户全景化需求

企业智图 一张图轻松管理企业数据

智能派单 一站式精准智能派单解决方案






文档与支持

文档与支持高德开放平台开发文档与服务支持 查看全部文档

API


Web基础服务API

Web高级服务API

物流服务API

猎鹰服务 API




JS API


JS API

数据可视化JS API

地图组件

URI API

地铁图 JS API




Android 平台


Android 地图SDK

Android 轻量版地图SDK

Android 定位SDK

Android 导航SDK

Android 猎鹰SDK




iOS 平台


iOS 地图SDK

iOS 轻量版地图SDK

iOS 定位SDK

iOS 导航SDK

iOS 猎鹰SDK




鸿蒙星河版平台


鸿蒙星河版地图SDK HOT

鸿蒙星河版定位SDK HOT

鸿蒙星河版导航SDK NEW




大模型开发工具


SKILL专区 NEW

MCP Server NEW

高德开放平台 CLI NEW




服务与支持


常见问题

创建工单

示例中心

合规中心

技术服务许可查询






定价

定价开放平台产品定价 产品定价

产品定价


产品定价

技术服务许可

GeoHUB自定义地图

GeoHUB数据中心




产品升级


高级能力

企业智图SaaS

云图市场






为什么选择高德




















历史记录

热门推荐
Android定位Android定位问题相关

浏览器定位JS API提供Geolocation定位插件

逆地理编码经纬度转换为详细结构化的地址

自定义地图7大类44种地图元素可定制

认证开发商商业授权相关问题














Web服务 API


概述

创建应用和 Key

入门指南

开发指南
基础 API 文档
地理/逆地理编码

路径规划

路径规划 2.0

行政区域查询

交通事件

IP定位

静态地图

坐标转换

轨迹纠偏


高级 API 文档
搜索POI

搜索POI 2.0

输入提示

天气查询

高级IP定位

智能硬件定位

交通态势查询

公交信息查询

高级路径规划


GeoHUB API文档
三方数据空间检索


实用工具
错误码说明

流量限制说明

天气对照表



常见问题

更新日志

相关下载






开发Web服务 API开发指南高级 API 文档智能硬件定位


智能硬件定位最后更新时间: 2025年11月05日


产品介绍

智能硬件定位 API 使用 HTTP 协议访问远程服务的接口，支持通过服务端上传 WIFI 和基站信息来实现定位，进而获取经纬度和其他位置信息。

适用场景

该服务仅适用于没有 Android 或 iOS 系统的智能硬件产品使用。如您的产品支持 Android 或 iOS 系统，建议使用 Android 定位 SDK或 iOS 定位 SDK以获得更精准效果和更丰富功能。

使用说明





1

第一步




申请 【Web服务API】密钥（Key）




2

第二步




拼接 HTTP 请求 URL，第一步申请的 Key 需作为必填参数一同发送




3

第三步


接收 HTTP 请求返回的数据（JSON 或 XML 格式），解析数据



如无特殊声明，接口的输入参数和输出数据编码全部统一为 UTF-8。


成为开发者并创建 Key 
为了正常调用 Web 服务 API ，请先注册成为高德开放平台开发者，并申请 Web 服务的 key ，点击具体操作。


智能硬件定位

智能硬件定位 API 服务地址

URL	请求方式
https://apilocate.amap.com/position?parameters	GET

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

参数名	含义	规则说明	是否必须	缺省值
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

表 1-2 内部参数说明

参数名称	参数含义	是否必填
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 时，必填

特别说明
为了尽可能地保证您定位结果的精确性，在以上所有场景中，除了必须填写的参数外，其他可以获得的参数​也请一并传入。 例如：wifi 接入网络的情况下，也可以传入其对应的基站信息；而在移动接入网络的情况下，也可传入 wifi 列表中 mac 信息（macs）。


返回结果参数说明

智能硬件查询的响应结果的格式由请求参数 output 指定。

名称	含义	规则说明
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 状态表 

Info 返回值	状态描述
OK	正常
INVALID_USER_KEY	用户 key 非法或过期
SERVICE_NOT_EXIST	请求服务不存在
SERVICE_RESPONSE_ERROR	请求服务响应错误
INSUFFICIENT_PRIVILEGES	无权限访问此服务
OVER_QUOTA	请求超出配额
INVALID_PARAMS	请求参数非法
UNKNOWN_ERROR	未知错误

服务示例

根据接入网络方式，可以分为三种定位场景，以下对三种定位场景给出对应示例。 


联网方式为 wifi 接入，即 accesstype = 1 时

https://apilocate.amap.com/position?accesstype=1&bts=460%2C0%2C29744%2C267330583%2C109&nearbts=460%2C0%2C29744%2C34467715%2C121&macs=0e%3A6f%3Ab0%3A6e%3Af1%3A1c%2C-63%2Ca|d8%3Ae8%3A44%3A5f%3A99%3A23%2C-64%2Ca|5a%3Abe%3A72%3A5a%3A6d%3A54%2C-64%2Ca|ba%3A60%3A61%3Abb%3Ade%3A93%2C-65%2Ca|da%3Ae8%3A44%3A1f%3A99%3A23%2C-65%2Ca|78%3A60%3A5b%3Ab2%3Ad7%3A06%2C-66%2Ca&cdma=0&imei=15030518977&output=json&platform=rest&key=<用户的key>

联网方式为移动接入且手机卡为非 cdma 卡，即 accesstype = 0 且 cdma = 0 时

https://apilocate.amap.com/position?cdma=0&imsi=&accesstype=0&network=GPRS&bts=460%2C0%2C37335%2C545%2Cnull&platform=rest&key=<用户的key>



联网方式为移动接入且手机卡为 cdma 卡，即 accesstype = 0 且 cdma = 1 时

https://apilocate.amap.com/position?ccesstype=0&bts=460%2C11%2C14916%2C61465907%2C-58&output=JSON&macs=24%3A69%3A8E%3A4E%3AD1%3A78%2C-84%2Cwifi1|54%3AA7%3A03%3AA3%3A7D%3A60%2C-88%2Cwifi2|26%3A69%3A8E%3A4E%3AD1%3A78%2C-93%2Cwifi3&cdma=1&imei=864789054739647&network=WCDMA&key=<用户的key>&platform=rest
智能硬件定位 2.0

智能硬件定位 2.0 API 服务地址

URL	请求方式
https://restapi.amap.com/v5/position/IoT?parameters	POST

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

​请求参数

参数名	含义	规则说明	是否必填	缺省值
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		逆地理编码结果开关	否	无

特别说明
网络定位依赖 WiFi、基站信息作为输入。为了尽可能地保证您定位结果的精确性，在以上所有场景中，除了必须填写的参数外，其他可以获得的参数也请一并传入。例如：WiFi 接入网络时，也可以传入其对应的基站信息；移动接入网络时，也可以传入 WiFi 列表信息。 


返回参数

返回数据格式类型为 JSON

名称	类型	说明
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 …(内容过长已截断)

------
导航页 打开网址