导航|地址|刷新
API 接口文档-个推文档中心






文档中心开发者中心

，欢迎您！

您的优惠服务将于到期。





基本资料



安全设置



应用管理




退出登录
登录/注册SDK下载个推学堂请选择产品
消息推送

用户运营

OneID服务

AI应用工坊

统计分析

用户分析

标签管理

模型管理

短信服务

数字人外呼

一键认证

合规检测

点击提升







体验更多产品服务


欢迎登录开发者中心

立即登录

本月不再提醒





产品简介

开通指南

客户端
Android
集成文档

API文档


iOS
集成文档

API文档


HarmonyOS
集成文档

API接口


H5&小程序
集成文档

API文档



SDK更新日志




当前位置：个推OneID > 客户端 > HarmonyOS > API接口



API 接口文档


API 接口文档

接口类说明

本文档所有接口所涉及的相关类及说明如下：

初始化

类名	OneID
接口	static init(context: Context): Promise<string>

说明：

初始化SDK，获取OneID。

参数：

context： Context

示例代码：
OneID.init(this.context) .then((ret) => { hilog.info(0x0000, 'testOneID', 'OneID.init %{public}s', ret) }) .catch((err: Error) => { hilog.info(0x0000, 'testOneID', 'OneID.init Error %{public}s', err.message) })
回调参数：
requestId: 单次请求ID
oneAID: 唯一ID
{ "requestId": "8af18ba411d14053824588c3147414f7", "oneAID": "A-d141229c1d62fc335f1ea77bf97d7399" }
场景查询

类名	OneID
接口	static queryLBS(context: Context, gpsInterval: number, gpsTimeOut: number): Promise<string>

说明：

查询场景信息

参数：

gpsInterval: GPS有效期设置，可以设置范围为-1 或 [0, 600]，单位秒。0：实时获取GPS数据。 -1：只使用系统缓存的GPS数据
gpsTimeout: GPS实时定位超时时间设置，可以设置范围为[10, 60]，单位秒, 建议设置20

说明:

获取gpsInterval时间间隔内的GPS数据，如果超出间隔则实时获取GPS数据，进行查询场景信息

SDK不会主动获取定位权限，需要开发者发起定位授权，SDK会根据当前用户的授权状态来进行查询。

未授权定位\定位失败\定位超时等，都将使用ip进行场景查询。

示例代码：
//设置GPS有效期为30秒，超时20秒，进行场景查询 OneID.queryLBS(this.context, 30, 20) .then((ret) => { hilog.info(0x0000, 'testOneID', 'OneID.queryLBS %{public}s', ret) }) .catch((err: Error) => { hilog.info(0x0000, 'testOneID', 'OneID.queryLBS Error %{public}s', err.message) })
回调参数：

requestId: 单次请求ID
sceneInfoList: 场景信息
coarseAddress: 粗略位置
addressCode: 位置代码
{ "requestId": "xxxxxxxxf0eb4432897d6be2xxxxxxxx", "sceneInfoList": [ { "sceneTypeList": [ { //一级分类，指该位置所属的场景的类型，如：交通设施服务、购物服务、餐饮服务等。"st1": "科教文化服务" } ] } ], "coarseAddress": "xxxxxx", "addressCode": { //省Code "province": "450000", //市Code "city": "450100", //区Code "area": "450108" } }
获取 SDK 版本号

类名	OneID
接口	static getVersion(): string

说明：

获取当前 SDK 版本号

返回：

当前 SDK 版本号字符串




以上文档对您是否有帮助？
有帮助没帮助



您的改进建议

是否遇到以下问题

问题类型


1、内容与功能不一致；

2、文章描述不清晰；

3、图片和视频难理解；

4、对产品功能不满意；

5、不是我想要的内容；

6、其他:


问题类型不能为空



反馈建议



联系方式



取 消提 交





反馈成功

非常感谢您的反馈，我们会继续努力做到更好！
确定






在这篇文章中：接口类说明初始化场景查询获取 SDK 版本号







文档中心搜索

搜 索















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