Editor

Editor 产品会将 Kaleidr 地图编辑器挂载到您的页面中。它采用 attach 接入方式 — MapLibre 与编辑器界面一起运行在父文档中， 并由您的应用控制。

决定其能否正常工作的三个关键因素

要素	说明
接入方式	attach — 编辑器挂载在您的页面内。MapLibre 不在 iframe 中运行，而是在父文档中运行。
所需作用域	design — 密钥必须包含 design 能力。
最低套餐	Pro — Free 套餐的密钥不允许使用 design 作用域。

浏览器能够将 publishable 密钥交换为会话之前，您的页面来源必须 位于该密钥的 origin allowlist 中。Editor 在父文档中运行的 MapLibre 还要求客户 CSP 中包含 'wasm-unsafe-eval' — 请参阅 Content Security Policy。

各组件的位置

• SDK 参考 — Editor attach — 属性、挂载 选项和 handle matrix（destroy, setCamera）。
• 指南：
  • 连接编辑器 — 从开始到结束的完整 挂载模式。
  • 上传您的业务数据 — 仅 Enterprise 可用的 vendor-data 上传流程。

唯一需要的代码片段

最小可用的编辑器挂载。目前在挂载时支持 pitch 和 bearing； 挂载后的实时相机更新将在 editor-ui SDK 版本中提供， 该版本与本文档分开跟踪。

<div id="editor" style="height:640px"></div>
<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<script>
  Kaleidr.mount('#editor', {
    product: 'editor',
    publishableKey: 'kld_pk_live_…',
  });
</script>