/**
 * 高德地图错误处理工具
 * 提供友好的错误提示和解决方案指引
 */
/**
 * 错误类型枚举
 */
export declare enum ErrorType {
    /** SDK 未初始化 */
    SDK_NOT_INITIALIZED = "SDK_NOT_INITIALIZED",
    /** 隐私协议未确认 */
    PRIVACY_NOT_AGREED = "PRIVACY_NOT_AGREED",
    /** API Key 配置错误 */
    INVALID_API_KEY = "INVALID_API_KEY",
    /** 权限未授予 */
    PERMISSION_DENIED = "PERMISSION_DENIED",
    /** 定位失败 */
    LOCATION_FAILED = "LOCATION_FAILED",
    /** 原生模块不可用 */
    NATIVE_MODULE_UNAVAILABLE = "NATIVE_MODULE_UNAVAILABLE",
    /** 地图视图未初始化 */
    MAP_VIEW_NOT_INITIALIZED = "MAP_VIEW_NOT_INITIALIZED",
    /** 参数错误 */
    INVALID_PARAMETER = "INVALID_PARAMETER",
    /** 网络错误 */
    NETWORK_ERROR = "NETWORK_ERROR"
}
/**
 * 错误详情接口
 */
export interface ErrorDetails {
    /** 错误类型 */
    type: ErrorType;
    /** 错误消息 */
    message: string;
    /** 解决方案 */
    solution: string;
    /** 文档链接 */
    docUrl?: string;
    /** 原始错误 */
    originalError?: Error;
}
/**
 * 自定义错误类
 */
export declare class GaodeMapError extends Error {
    type: ErrorType;
    solution: string;
    docUrl?: string;
    originalError?: Error;
    constructor(details: ErrorDetails);
}
/**
 * 错误处理器类
 */
export declare class ErrorHandler {
    private static docBaseUrl;
    /**
     * SDK 未初始化错误
     */
    static sdkNotInitialized(): GaodeMapError;
    /**
     * 隐私协议未确认错误
     */
    static privacyNotAgreed(scene: 'map' | 'sdk'): GaodeMapError;
    /**
     * API Key 配置错误
     */
    static invalidApiKey(platform: 'android' | 'ios' | 'both'): GaodeMapError;
    /**
     * 权限未授予错误
     */
    static permissionDenied(permissionType: 'location'): GaodeMapError;
    /**
     * 定位失败错误
     */
    static locationFailed(reason?: string): GaodeMapError;
    /**
     * 原生模块不可用错误
     */
    static nativeModuleUnavailable(): GaodeMapError;
    /**
     * 地图视图未初始化错误
     */
    static mapViewNotInitialized(methodName: string): GaodeMapError;
    /**
     * 参数错误
     */
    static invalidParameter(paramName: string, expected: string, received: unknown): GaodeMapError;
    /**
     * 网络错误
     */
    static networkError(originalError?: Error): GaodeMapError;
    /**
     * 包装原生错误，提供更友好的提示
     */
    static wrapNativeError(error: unknown, context: string): GaodeMapError;
}
/**
 * 错误日志工具
 */
export declare class ErrorLogger {
    private static isEnabled;
    /**
     * 启用/禁用错误日志
     */
    static setEnabled(enabled: boolean): void;
    /**
     * 记录错误
     */
    static log(error: GaodeMapError): void;
    /**
     * 记录警告
     */
    static warn(message: string, details?: unknown): void;
}
//# sourceMappingURL=ErrorHandler.d.ts.map