开发 Web服务 API 开发指南 高级 API 文档

室内店铺级定位 最后更新时间: 2024年01月24日

产品介绍

室内店铺级定位 API 使用 HTTP/HTTPS 协议访问远程服务的接口,目前已覆盖全国所有的大中型商超,定位精度可达到店铺级别

使用 API 前您需先 申请 Key,若无高德地图 API 账号需要先申请账号。

提示

室内店铺级定位接口属于高级服务接口,对于已通过企业认证的用户,我们提供每日一定量的配额以供体验(流量限制说明)。如需更多配额,可进行 商务咨询

成为开发者并创建 Key 

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

适用场景

用于获取指定位置的 POI 信息,适用于各种需要位置查询、导航服务、本地生活服务和商业分析的应用场景。

使用说明

第一步,申请” Web 服务 API ”密钥(Key);

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

第三步,接收 HTTP 请求返回的数据(JSON 或 XML 格式),解析数据。

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

室内店铺级定位服务目前只向企业开发者开放。

您通过企业开发者审批之后,可在 控制台-个人中心-帐号权限 页面查看调用量限制,也可在 控制台-数据分析 查询该服务的每日调用情况。

室内店铺级定位

室内店铺级定位 API 服务地址

URL

https://restapi.amap.com/v5/position/poi?parameters

请求方式

POST

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

请求参数

业务参数以 Form 表单形式提交(Content_Type :application/x-www-form-urlencoded),其中 wifiList 与 cellList 参数需要组织成为 JSON字符串(非 JSON 格式提交)具体如下:

名称

类型

含义

是否必须

备注

key

String

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

wifiList

String

WiFi 列表 JSON 字符串

是,wifi 基站至少存在一种

cellList

String

基站列表 JSON 字符串

包含 Gsm/Cdma/Lte /Wcdma/Nr

lon

Double

用户坐标经度 02坐标系

强烈建议填写,坐标缺失可能会导致定位错误。

lat

Double

用户坐标纬度 02坐标系

locTime

Double

用户位置获取的时间戳(毫秒)

locType

String

用户位置获取的方式

gps/network

diu

设备id

设备唯一 ID 用于问题排查

无 diu 问题无法排查

  • wifiList 参数含义

名称

类型

含义

是否必须

备注

mac

string

mac 地址

signal

Integer

WiFi 信号强度

rssi 信号强度 ,值越大信号越强

freshness

Integer

新鲜度

默认无效值 -1

新鲜度值越大(数据越陈旧),偏离实际位置可能越大

单位秒,表示信号不变持续的时间

isLinked

boolean

当前是否连接该 WiFi

0:相邻 WiFi

1:主 WiFi

默认值为 0

ssid

string

WiFi 名称

frequency

Integer

频率

默认值为 0

  • cellList 参数含义

名称

类型

含义

是否必须

备注

mcc

Integer

mcc

Mobile Country Code

mnc

Integer

mnc

是 

Mobile Network Code. 

GSM / WCDMA / LTE / NR : MNCCDMA : SID

lac

Integer

lac

是 

The Location Area Code 

GSM/WCDMA : LAC CDMA : NID

LTE / NR : TAC

cellId

Double

cellId

GSM/WCDMA/LTE / NR : cellidCDMA : BSID

signal

Integer

信号强度

是 

rssi 信号强度 ,值越大信号越强

isMainCell

boolean

是否主基站

默认 false

freshness

Integer

基站新鲜度

默认无效值 -1

新鲜度值越大(数据越陈旧),偏离实际位置可能越大

单位秒,表示信号不变持续的时间

cellType

String

基站类型 

Gsm 

Cdma 

Lte 

Wcdma 

Nr

参考枚举 CellType 类

返回结果参数说明

关键字搜索的响应结果的格式由请求参数output指定。

名称

类型

说明

备注

status

string

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

info

string

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

infocode

string

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

resultList

List

到店定位结果列表

count

int

到店定位结果数量

resultList

string

定位结果列表

location

string

坐标点

定位结果坐标点信息

title

string

定位结果名称

confidence

double

置信度

取指范围 0-1,置信度越高结果越准确

poi

List

店铺级定位结果

对于同一个定位请求,

由精细到粗略最多返回四个层级:

店铺级、建筑级、小区级、商圈级。

building

List

建筑级定位结果

block

List

小区级定位结果

area

List

商圈级定位结果

  • POI/Building/Block/Area属性表

属性名

类型

含义

备注

id

String

唯一 ID

name

String

名称

floor

int

楼层 

该字段只存在于 POI 信息中

location

string

坐标点

定位结果坐标点信息

typeCode

String

兴趣点类型编码

获取 POI TYPECODE 可以参考 POI分类码表

服务示例

curl 'restapi.amap.com/v5/position/poi?key=<用户的key>&diu=icmc9bcc7f776iibl888875a397bab' -d 'wifiList={"wifiList":[{"mac":"f0:55:01:fa:48:e8","signal":-16,"freshness":2412,"isLinked":false,"ssid":"360-XH2","frequency":1},{"mac":"ba:80:35:cc:52:fc","signal":-48,"freshness":2412,"isLinked":false,"ssid":"AndroidAP_9057","frequency":1}]}&lon=120.649298&lat=27.997220&locTime=1642423923219&cellList={"cellList":[{"mnc":1,"cellType":"Gsm","isMainCell":true,"mcc":460,"cellId":3439381,"freshness":0,"signal":-113,"isNewCell":false,"lac":4149},{"mnc":1,"cellType":"Gsm","isMainCell":false,"mcc":460,"cellId":3439381,"freshness":0,"signal":-113,"isNewCell":false,"lac":4149}]}'

流量限制说明

服务

个人认证开发者 

企业开发者 

日调用超量封停

(次/日)

QPS

(次/秒)

日调用超量封停

(次/日)

QPS

(次/秒)

室内店铺级定位

不开放

100

1

返回顶部 示例中心 常见问题 智能客服 公众号
二维码