地図公開とは、編集可能な地図を、他の人が開いたり埋め込んだり製品内で利用したりできる安定した体験に変えることです。主な選択肢は、単独の共有リンク、埋め込みViewer、より深いアプリケーション統合です。本番地図にはURLだけでなく、アクセス規則、埋め込み許可ドメイン、ライブ版、モバイルレイアウト、ロールアウトと公開停止の手順、計測も必要です。
以下では、公開モデル、アクセスとドメインの制御、埋め込みレイアウト、メッセージング、バージョン管理、分析、Kaleidr StudioとViewerの画面を説明します。製品情報はKaleidr Studioをご覧ください。埋め込みの仕組みはインタラクティブ地図をWebサイトに埋め込む方法、ビルダーとAPIの責任分担はノーコード地図ビルダーと地図API、SDKのマウントはAI地図SDKとは？を参照してください。
公開の要点
- 作成 ≠ 公開： 下書きは変更できますが、公開地図には安定した利用画面が必要です。
- 結合度を選ぶ： 共有リンクは軽量、埋め込みはページ内、製品統合はアプリ状態を共有します。
- ホストを制限する： 許可ドメインとオリジン検証は公開契約の一部です。
- 領域を確保する： 埋め込みの高さが潰れるのはレイアウトの不具合であり、地図の不具合ではありません。
- 安定IDの背後で版を管理する： 各ホストページを書き換えずに計測、レビュー、リリース、ロールバックできます。
地図公開とは何ですか？
地図の作成と公開は異なる段階です。作成中は、場所、レイヤー、ラベル、色、タイル、カメラ、フィルター、操作、データソースを変更できます。公開すると、単独ページ、Webサイト埋め込み、SaaSの店舗検索、編集記事用地図、社内の読み取り専用ビューなど、利用者向けの画面が作られます。作成ツールは下書きを許容できますが、公開地図には予測可能なアクセス、レイアウト、性能、動作、バージョン、帰属表示、監視が必要です。Kaleidr Studioは現在、作成をPrompt → Process → Refine → Deployと説明し、完成した地図を単独ページまたは埋め込みウィジェットとして公開できるとしています（Studio）。
公開地図は共有、埋め込み、統合のどれを選ぶべきですか？
多くの公開は3モデルで対応できます。共有リンクはホスト側の実装がほぼ不要なため、レビュー、キャンペーン、ガイドに最速です。埋め込みViewerは、地図を本文やCTAと並べるWebサイト、ランディングページ、CMS、顧客ポータルに向きます。製品統合は、フィルター、選択レコード、アプリ状態を地図と同期するSaaS、マーケットプレイス、独自ワークフロー向けです。地図が主にコンテンツなのか、埋め込み体験なのか、アプリ状態の一部なのかで選びます。共有リンクから始め、後で埋め込みや製品コンポーネントへ移行することもできます。
| モデル | 最適な用途 | ホスト側の開発 | 製品との結合 |
|---|---|---|---|
| 共有リンク | レビュー、キャンペーン、ガイド | 最小 | 低い |
| 埋め込みViewer | Webサイト、CMS、ポータル | 少ない | 中程度 |
| 製品統合 | SaaS、独自ワークフロー | 多い | 高い |
Kaleidrの現在の開発者ドキュメントでは、公開Viewer地図は共有リンクで制限され、一般的なAPIキーではなく共有IDで指定されます（Viewer Embed）。共有IDは公開体験を識別するもので、サーバーの秘密情報ではなく、そのように扱ってはいけません。Studioは現在、公開後に地図をウィジェットとして埋め込めるとしています。Chatは既存のホスト地図に接続でき、Viewerは公開済み地図体験を中心に設計されています（kaleidr.js）。
本番埋め込みでレイアウト、アクセス、メッセージングをどう扱いますか？
公開前に契約を決めます。公開または制限付きアクセス、許可する埋め込みドメイン、下書き・公開・アーカイブ状態、ライブ画面でレビュー済みデータスナップショットを表示するかどうかです。ドメイン制御にはhttps://www.example.comやhttps://app.example.comのような純粋なオリジンを使用します。Viewerの現在の文書では、発行者が埋め込み公開地図の許可ドメインを設定します。ログイン保護されたホストページでも、独立してアクセスできる地図URLが自動的に非公開になるわけではありません。非公開の業務データには、その用途向けの認可アーキテクチャが必要です。
埋め込みが潰れないよう高さと幅を確保します。HTML仕様では、支援技術が入れ子の閲覧コンテキストを識別できるよう、iframeに簡潔なtitleを付けることを推奨しています（HTML Standard）。フレームにプログラムで特定できる名前を求めるハード要件は WCAG 4.1.2 にあります。画面外の埋め込みには、対応するloading="lazy"を使います。HTML標準が遅延読み込み属性を定義し、web.devも通信量と起動処理を減らすため画面外iframeの遅延を推奨しています。一方、最初から見える主要地図は重要な体験として読み込みます。Viewerが失敗してもページが機能するよう、場所名、住所、一覧などのテキスト代替を用意してください。
クロスオリジン通信は制御されたチャネルで行います。window.postMessage()はウィンドウとiframe間の標準機構です（HTML Standard）。受信時はevent.originを検証し、送信時は特定のターゲットオリジンを設定します。既定で"*"を使ってはいけません。Viewer文書では、対応動作のためのkaleidr-embed:*メッセージ境界を説明しています。Viewerとホストの状態は分離します。公開地図がViewer内のカメラと選択を管理し、ホストページがナビゲーション、フォーム、コンバージョンを管理します。
// Published Viewer mount: share ID, not a server key
Kaleidr.mount("#published-map", {
product: "viewer",
shareId: "YOUR_SHARE_ID"
});
公開地図のバージョン管理、計測、ロールバックはどう行いますか？
下書き保存とライブ版公開は同じではありません。コンテンツ変更でホストページが壊れないよう、場所と埋め込みに安定したIDを維持します。そのIDの背後で、新しい下書きの編集、データ品質とモバイル表示のレビュー、公開、本番確認、失敗時のロールバックを行います。地図の読み込み回数以外も計測してください。地図準備完了、場所選択、CTA、エラーが有用です。製品が自動イベントとして明記しない限り、これらの名前は編集上の推奨とみなします。下書き実験が本番ファネルに混ざらないよう、作成分析とViewer分析を分離します。
ブロックされたドメイン、未公開共有ID、低速回線、テキスト代替の欠落をテストします。本番ドメイン、Content Security Policy、帰属表示、外部リンクの安全性も同じリリースの一部です。CMSページには確保済みコンテナとレビュー済みスナップショット、SaaS製品にはアプリ状態との結合、マーケティングページには地図操作だけに依存しないコンバージョン経路が必要です。リアルタイム地図や3D地図は性能と代替の負担が大きいため、ホストページがそのコストを吸収できる場合だけ公開します。
避けるべき地図公開の誤りは何ですか？
| 誤り | リスク | より良い方法 |
|---|---|---|
| 下書きURLを本番扱いする | 不安定な内容と壊れた埋め込み | レビュー済みスナップショットを公開 |
| 高さを確保せず埋め込む | レイアウトシフトと潰れた地図 | アスペクト比または明示サイズを設定 |
| 主要地図を遅延読み込みする | 最初の画面が空白 | 画面上部の地図を即時読み込み |
postMessage("*")を使う |
クロスオリジン偽装 | オリジンを検証して指定 |
| 共有IDを秘密鍵として扱う | 混乱したアクセスモデル | サーバー鍵はバックエンドに保持 |
| 許可ドメインを確認しない | 想定外のホストで再利用 | 埋め込みオリジンを制限 |
| 非公開行を公開共有する | データ漏えい | 公開前に認可 |
| 編集ごとに埋め込みIDを変える | ホストページの破損 | 安定IDの背後で版管理 |
| 読み込みだけを計測する | 製品質を把握できない | 準備、選択、CTA、エラーを追跡 |
| テキスト代替を用意しない | Viewer障害時に空白 | 重要情報をHTMLにも記載 |
最終結論
地図公開を成功させるには、ライブ地図をエクスポートではなく製品画面として扱います。ホスト内容やアプリ状態との結合度に応じ、共有、埋め込み、統合を選びます。そのうえで、アクセス、許可ドメイン、確保済みレイアウト、オリジン検証済みメッセージング、バージョン、計測、ロールバックという本番契約を加えます。Kaleidr Studioは現在、単独ページと埋め込み可能なウィジェットを公開し、Kaleidr Viewerは共有IDで公開地図を指定します。この分離により作成を迅速に保ちつつ、ホストページがコンバージョン、アクセシビリティ、リリース規律を担います。
Kaleidr Studioで地図を公開する
地図を作成、レビューし、単独ページまたは埋め込みウィジェットとして展開して、必要な場所に公開Viewerをマウントします。公開するには**Kaleidr Studioを開く**、Viewer共有ID、許可ドメイン、SDKマウントについては開発者ドキュメントをご覧ください。
よくある質問
地図公開とは何ですか？
編集可能な地図を、他の人が開いたり埋め込んだり製品内で使ったりできる安定した体験に変え、アクセス、レイアウト、バージョン、計測を管理するプロセスです。
共有リンクと埋め込みの違いは何ですか？
共有リンクは公開地図を独立ページで開きます。埋め込みは公開地図をホストサイトや製品のレイアウト内に配置します。
埋め込みではなく製品統合を使うのはいつですか？
フィルター、選択レコード、ワークフロー状態を、単独Viewerの周囲に置くだけでなく地図と同期する必要がある場合です。
Kaleidr ViewerにAPIキーは必要ですか？
現在の文書では、公開Viewer地図はAPIキーではなく共有リンクで制限されます。アクセスモデルは変わり得るため、導入前に最新文書を確認してください。
共有IDはAPIキーと同じですか？
いいえ。共有IDは公開地図体験を識別します。サーバーAPIキーは特権API操作を認可する秘密情報です。
地図埋め込みを遅延読み込みすべきですか？
画面下部または副次的なら通常は有効です。地図が主操作なら重要な体験として読み込み、起動を最適化します。
iframe地図をアクセシブルにするには？
iframeに簡潔なtitleを付け、有用な周辺HTML、キーボード操作、地図のドラッグを要しないテキスト情報を提供します。
異なるオリジンのページと埋め込み地図は通信できますか？
統合が対応していれば可能です。window.postMessage()を使い、特定のターゲットオリジンを指定して受信オリジンを検証します。
非公開の業務データを地図埋め込みで公開できますか？
公開と認可の構成がその用途向けに設計されている場合だけです。ホストページのログイン保護だけでは、独立した地図URLは非公開になりません。
公開地図にバージョン管理は必要ですか？
変更が顧客、埋め込み、レポート、業務フローに影響するなら必要です。ロールバックとデバッグが大幅に安全になります。
Kaleidr Studioはコードなしで地図を公開できますか？
はい。現在のStudioページでは、視覚的に地図を作成・調整し、単独ページまたは埋め込みウィジェットとして公開できると説明しています。
参考資料
- Kaleidr. Design Custom Maps, Powered by Spatial AI. Kaleidr Studio. 2026年8月19日参照。 https://kaleidr.com/studio
- Kaleidr. kaleidr.js Loader. Kaleidr Developer Documentation. 2026年8月19日参照。 https://docs.kaleidr.com/sdk/kaleidr-js
- Kaleidr. Viewer Embed. Kaleidr Developer Documentation. 2026年8月19日参照。 https://docs.kaleidr.com/sdk/viewer-embed
- WHATWG. HTML Standard — Lazy loading attributes. 2026年8月19日参照。 https://html.spec.whatwg.org/multipage/urls-and-fetching.html#lazy-loading-attributes
- WHATWG. HTML Standard — The iframe element. 2026年8月19日参照。 https://html.spec.whatwg.org/multipage/iframe-embed-object.html#the-iframe-element
- W3C. Understanding Success Criterion 4.1.2: Name, Role, Value. WCAG 2.2. 2026年8月19日参照。 https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html
- WHATWG. HTML Standard — Posting messages. 2026年8月19日参照。 https://html.spec.whatwg.org/multipage/web-messaging.html#posting-messages
- web.dev. Lazy load images and iframe elements. 2026年8月19日参照。 https://web.dev/learn/performance/lazy-load-images-and-iframe-elements
@misc{kaleidr_studio_publish_2026,
title = {Design Custom Maps, Powered by Spatial AI},
author = {{Kaleidr}},
note = {Kaleidr Studio; accessed 19 August 2026},
url = {https://kaleidr.com/studio}
}
@misc{kaleidr_viewer_embed_2026,
title = {Viewer Embed},
author = {{Kaleidr}},
note = {Kaleidr Developer Documentation; accessed 19 August 2026},
url = {https://docs.kaleidr.com/sdk/viewer-embed}
}
@misc{kaleidr_js_loader_2026,
title = {kaleidr.js Loader},
author = {{Kaleidr}},
note = {Kaleidr Developer Documentation; accessed 19 August 2026},
url = {https://docs.kaleidr.com/sdk/kaleidr-js}
}
@misc{whatwg_iframe_2026,
title = {HTML Standard -- The iframe element},
author = {{WHATWG}},
note = {Accessed 19 August 2026},
url = {https://html.spec.whatwg.org/multipage/iframe-embed-object.html#the-iframe-element}
}
@misc{wcag_412_2026,
title = {Understanding Success Criterion 4.1.2: Name, Role, Value},
author = {{W3C}},
note = {WCAG 2.2; accessed 19 August 2026},
url = {https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html}
}
@misc{whatwg_lazy_loading_2026,
title = {HTML Standard -- Lazy loading attributes},
author = {{WHATWG}},
note = {Accessed 19 August 2026},
url = {https://html.spec.whatwg.org/multipage/urls-and-fetching.html#lazy-loading-attributes}
}
@misc{whatwg_postmessage_2026,
title = {HTML Standard -- Posting messages},
author = {{WHATWG}},
note = {Accessed 19 August 2026},
url = {https://html.spec.whatwg.org/multipage/web-messaging.html#posting-messages}
}
@misc{webdev_lazy_iframe_2026,
title = {Lazy load images and iframe elements},
author = {{web.dev}},
note = {Accessed 19 August 2026},
url = {https://web.dev/learn/performance/lazy-load-images-and-iframe-elements}
}