Viewer
Viewer 제품은 게시된 Kaleidr 지도를 share id로 임베드합니다. 키가 필요 없습니다 — share 자체가 권한이므로 publishable 키가 필요하지 않고 세션 교환도 실행되지 않습니다.
작동 여부를 결정하는 세 가지 요소
| 요소 | 설명 |
|---|---|
| 통합 방식 | iframe — 지도는 Kaleidr 자체 CSP 아래 map-embed.kaleidr.com 내부에서 로드됩니다. |
| 필수 범위 | 없음 — 키를 교환하지 않습니다. |
| 최소 플랜 | Free — share id를 가진 누구나 어떤 플랜에서든 Viewer를 임베드할 수 있습니다. |
Viewer 임베드에 키를 전달하면 product_not_allowed로 거부됩니다.
Viewer에는 키가 필요하지 않기 때문입니다. share-id는 필수이며 생략하면
bundle 로드 시 오류가 발생합니다.
각 구성 요소의 위치
- SDK 레퍼런스 — Viewer embed — 필수
share-id, 선택적 카메라 설정, handle matrix. - 가이드 — Kaleidr 지도 임베드.
하나의 스니펫
최소 구성 Viewer 임베드:
<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<kaleidr-map product="viewer"
share-id="YOUR_SHARE_ID"
style="height:480px"></kaleidr-map>