百度地图开放平台
更新时间: 2026/07/22 20:09
注意事项
鸿蒙导航SDK隐私合规接口

为了更好地保护最终用户的个人信息,规范 SDK 收集信息和获取设备标识的行为,鸿蒙地图 SDK 提供了统一配置对象 MapSDKConfig。开发者应在调用 Initializer.initialize() 前,先通过 Initializer.configure() 完成 MapSDKConfig 配置。
MapSDKConfig 当前包含以下能力:

  • privacyAgreed:是否同意隐私政策

  • oaidEnabled:是否允许 SDK 使用 OAID

其中,privacyAgreed 是地图初始化前的必选前置条件;如果未设置,Initializer.initialize() 会直接抛出异常。

隐私合规接口

鸿蒙地图 SDK 对外统一通过以下方式设置隐私状态和 OAID 开关:

import { Initializer, MapSDKConfigBuilder } from '@bdmap/base';
const config = new MapSDKConfigBuilder()
.setPrivacyAgreed(true)
.setOaidEnabled(true)
.build();
await Initializer.configure(config);

接口说明如下:

/**
* MapSDK 配置对象
*/
export interface MapSDKConfig {
/**
* 是否同意隐私政策
* true: 同意
* false: 不同意
* null: 未设置
*/
privacyAgreed: boolean | null;
/**
* 是否启用 OAID
* true: 启用
* false: 禁用
*/
oaidEnabled: boolean;
}
/**
* 配置构建器
*/
export class MapSDKConfigBuilder {
public setPrivacyAgreed(agreed: boolean): MapSDKConfigBuilder;
public setOaidEnabled(enabled: boolean): MapSDKConfigBuilder;
public build(): MapSDKConfig;
}
/**
* SDK 统一配置入口
* 必须在调用 Initializer.initialize() 之前完成 privacyAgreed 配置
*
* @param config MapSDKConfig 配置对象
*/
public static async configure(config: MapSDKConfig): Promise<boolean>

注:

  1. privacyAgreed 必须在调用 Initializer.initialize() 之前设置。

  2. MapSDKConfigBuilder 默认值为:

  • privacyAgreed = null

  • oaidEnabled = true

  1. 若 privacyAgreed 保持默认值 null,调用 Initializer.initialize() 时会抛出异常。

上一篇

工程配置与SDK集成

下一篇

基础功能
本篇文章对您是否有帮助?