当前位置：首页 > news >正文

腾讯地图智能硬件定位

news 2026/4/16 20:04:19

腾讯地图智能硬件定位（Network Location API）文档

接口名称：智能硬件定位（网络定位/后台定位）
接口地址：https://apis.map.qq.com/ws/location/v1/network

一、接口概述

本接口提供根据WiFi、基站、蓝牙、GPS信息进行网络定位的能力，适用于无法使用腾讯定位SDK的智能硬件、终端设备，由终端自行采集信息后调用服务完成定位。

核心要求：

请求方式：POST
请求头：Content-Type: application/json
必选：key + device_id
至少传入gpsinfo / wifiinfo / cellinfo / beaconinfo其中一项

二、请求参数（JSON）

基础参数

参数	类型	必填	说明
key	string	是	开发密钥
device_id	string	是	设备唯一标识（如IMEI）
get_poi	number	否	0=不返回周边POI（默认），1=返回
get_indoor_info	number	否	0=不返回室内信息（默认），1=返回（需商务开通）

GPS信息（gpsinfo）

字段	类型	说明
latitude	number	纬度（WGS84，度，6位小数）
longitude	number	经度（WGS84，度，6位小数）
altitude	number	海拔（米，整数）
accuracy	number	精度（米，整数）
speed	number	速度（米/秒，1位小数）
bearing	number	方向角（度，正北0°顺时针）
viewstar	number	可见卫星数
usedstar	number	已用卫星数

基站信息（cellinfo，数组）

字段	类型	说明
mcc	number	移动国家码（如460）
mnc	number	移动网络码
lac	number	位置区码（GSM/LTE/5G）
cellid	number	小区ID
rss	number	信号强度（dBm）

WiFi信息（wifiinfo，数组）

字段	类型	说明
mac	string	WiFi MAC（可用:/-分隔）
rssi	number	信号强度（dBm）

蓝牙信标（beaconinfo，数组）

字段	类型	说明
mac	string	Beacon MAC
major	number	Beacon major
minor	number	Beacon minor
rssi	number	信号强度（dBm）
time	number	扫描时间戳（毫秒）

三、响应结构（JSON）

{"status":0,"message":"Success","request_id":"唯一ID","result":{"address":"北京市朝阳区...","location":{"latitude":39.923306,"longitude":116.518592,"altitude":0,"accuracy":3000},"ad_info":{"adcode":"110105","nation":"中国","province":"北京市","city":"北京市","district":"朝阳区"},"pois":[...],// get_poi=1时返回"indoor_info":{// get_indoor_info=1时返回"bid":"楼宇ID","floor":"F3"}}}

关键字段

status=0：成功
location：定位坐标（GCJ-02）
ad_info：行政区划
accuracy：定位精度（米）

四、请求示例（精简）

{"key":"YOUR_KEY","device_id":"869896021034807","gpsinfo":{"latitude":39.922049,"longitude":116.513457,"accuracy":150},"wifiinfo":[{"mac":"78a106a5b166","rssi":-81}]}