腾讯地图 智能硬件定位

腾讯地图 智能硬件定位（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 }
  ]
}

---

五、使用要点

1. 至少一种定位数据源（GPS/WiFi/基站/蓝牙）
2. device_id必须唯一，用于服务优化
3. 坐标为GCJ-02（火星坐标系）
4. 室内定位、多POI等为高级付费功能

更多api试用及技术支持请联系vx:yyacm12