メインコンテンツまでスキップ

変更履歴

埋め込み SDK、プラットフォーム API、およびこのドキュメントの主な変更点です。SDK のバージョンは /embed/v1/*、API は /inference-api/b2b/v1/* で管理されます。互換性のない変更は旧バージョンと並行して新しいメジャーバージョンで公開されます（CDN バージョン管理）。新しいストリームイベントやレスポンスフィールドなどの追加的な変更はバージョンを変更せずに提供されるため、クライアントは認識できない要素を無視する必要があります。

2026-10-21：Viewer のチャットバーと、地図自身の場所による回答の有効化​

  • ページ用のチャットバー。 <kaleidr-map product="viewer" layout="bar"> は、訪問者の質問で公開地図を開く質問欄です。既定ではページの上に重ねて開き、results-url を指定すると自分のページで開きます。タイトル、プレースホルダー、質問例、アクセントカラー、テーマ、言語は属性で指定します。チャットバーを参照してください。
  • Viewer を質問付きで開けるように。 prompt（ページの URL から読み取る場合は prompt-param）と iframe の q パラメーターは、地図を開いたときに地図の Kaleidr AI へ質問を投げかけ、handle.send() はコードから質問します。追加の変更のため、バージョンは変わりません。
  • 地図自身の場所による回答を有効化。 公開地図や共有リンクの Ask Kaleidr パネルは、地図に表示された名前付きの場所をまず使って回答します。地図自身の場所を使う回答を参照してください。
  • テンプレートストアがコードを作成。 template.kaleidr.com で、選んだ地図の両方のスニペットを生成できます。ダウンロード用のウェブサイトテンプレートは廃止されました。

2026-10-18：共有リンクの Kaleidr AI には地図の公開が必要​

  • 共有リンクの Kaleidr AI は、地図の公開を停止すると止まるようになりました。 また、リンクのスナップショットではなく、地図の現在の許可ドメインに含まれるページでのみ動作します。地図の公開停止やページのドメインの削除で、公開地図と同じく 5 分以内に止まり、再公開すると元に戻ります。Control Tower と Popup Window のスイッチは引き続きスナップショットに従い、リンク自体は地図を表示し続けます。地図が公開されていない共有リンクに対して、POST /sdk/share-sessions は 404 not_found を返します。公開地図の Kaleidr AI を参照してください。

2026-10-16：公開地図の Kaleidr AI は地図自身のスイッチに従う​

  • 地図の Kaleidr AI タイルが唯一のスイッチになりました。 Studio で Control Tower をオンにすると公開地図の訪問者に Ask Kaleidr パネルが、Popup Window をオンにするとポップアップ内の AI チャットが提供されます。iframe でも Viewer 要素でも同じです。Share、Embed の Visitor AI Chat スイッチは廃止されました。公開地図で Kaleidr AI を使うを参照してください。
  • 地図単位の月間上限はなくなりました。 Monthly AI Credit Limit 欄は廃止されました。訪問者はプランの付与枠まで所有者の AI クレジットを消費します。訪問者単位と地図単位のレート制限は変わりません。
  • POST /sdk/share-sessions が feature を受け付けます。 control_tower（既定）または popups で、それぞれスイッチがオンの間だけ許可され、それ以外は 403 chat_disabled になります。POST /sdk/share-sessions を参照してください。
  • 共有リンクでも Kaleidr AI を開けるようになりました。 その ID には、リンクのスナップショット、つまりリンク作成時点の Control Tower と Popup Window のスイッチおよび許可ドメインに基づいて許可が与えられ、費用は地図の所有者が負担します。Studio で Kaleidr AI をオフにしても、すでに配布した共有リンクでは止まりません。存在しない ID は引き続き 404 not_found です。
  • Viewer と Tile は Studio と同じくスクロールでズームします。 ポインターが地図上にあれば Ctrl や ⌘ なしでスクロールによりズームし、ポインターが地図の外にあればスクロールでページが動きます。iframe の gestures=greedy パラメーターは読み取られなくなりました。

2026-10-14：地点情報と 2 つの非推奨エンドポイント​

  • 新規：POST /spot と POST /spot/overview/stream。 /spot は指定した地点に何があるかを返します。クリックされた場所、最寄りの住所、その地点を含む地域について、それぞれ表示すべき出典情報を含めて返し、要求に応じて場所の説明と写真も追加します。/spot/overview/stream は返された対象の概要を、その場所の正式な名前を示す place フレームに続けてストリーミングします。POST /spot を参照してください。
  • /spot は、呼び出しのためにコンテンツを取得した場合にのみコンテンツ料金を課金します。 以前のリクエストで取得済みのコンテンツは無料のため、/spot によるコンテンツ取得の料金は /retrieval/poi/enrich と同じか、それより低くなります。
  • 非推奨：GET /retrieval/poi/enrich と POST /chat/summary/stream。 2027-01-15 までは従来どおり動作し、その後はいつでも削除される可能性があります。レスポンスには Deprecation、Sunset、後継への Link が含まれます。非推奨エンドポイントからの移行 を参照してください。
  • tenants を返すようになりました。 /spot は建物内の事業者を、非公開にする代わりに CDLA-Permissive-2.0 に従って poi: 参照を持つ tenant エンティティとして返します。この取得は引き続き無料です。
  • 要約は毎回課金されます。 場所の要約や概要は、毎回使用したトークン数に応じて課金されます。start と end イベントの cached フィールドは送信されなくなりました。
  • 建物の要約に後継機能はありません。 建物の概要は API から取得できません。API が返さない情報 を参照してください。 /spot/overview/stream は ID のない building: も受け付け、building:<id> と同じく error フレーム1つで応答します。

2026-10-13：製品変更とドキュメントの修正・拡充​

この項目は 2 つの部分で構成されます。製品の変更とAPI の制限と拒否では、このリリースで製品に加わった変更を説明します。これらのページの訂正では、実際の製品にはない動作を記載していた箇所を示します。SDK と API を基準に各ページを 1 行ずつ確認して修正し、説明を拡充しました。以前の文書に基づいて実装している場合は、訂正内容を確認してください。

製品の変更​

  • 事業者データは Kaleidr Studio からアップロードします。 アップロード画面は各地図のデータパネル最下部にある Data for AI Answers です。.csv または .json を選択し、CSV の列マッピングを提案・確認してプレビュー、公開し、Releases 一覧で結果を確認します。アップロード画面はここだけです。アップロード権限のある組織の所有者と管理者だけに操作項目が表示され、既存のアップロード API と同じ処理を使用します。Enterprise を離れてもリリースが残っている組織では、所有者と管理者に「アップロードは Enterprise プランの機能です」という説明と Releases 一覧が引き続き表示されます。それ以外の Enterprise 未満の組織では、この項目は表示されません。独自データによる回答 と アップロードできない場合の表示 を参照してください。
  • 事業者データのアップロードと回答への利用は Enterprise 限定です。 Enterprise 組織の所有者または管理者がアップロード・公開でき、Kaleidr Studio のアシスタントは組織が Enterprise を利用している間だけ、そのデータを使ってサインイン済みの組織メンバーに回答します。Free と Pro ではアップロードできません。場所数、文書数、ファイルサイズの上限は組織ごとの契約で定められ、プラットフォーム全体の上限を超えません。上限超過には、上限値とプランを理由に含む 422 が返されます。適用されるのは kaleidr.com/billing で購入・変更した組織のプランです。API キーや SDK 経由で読み取るには、同じく Enterprise 限定の vendor スコープが必要です。プラン別の利用可否 を参照してください。
  • 地図上のデータセットの制限はプランによって異なります。 サインイン済みユーザーが Kaleidr Studio のデータパネルから地図に追加するファイルはすべてのプランで利用できますが、制限があります。Free ではデータセット 1 件につき 50,000 行、ファイル 1 件につき 32 MiB、組織全体で 250,000 行です。Pro ではそれぞれ 100,000 行、64 MiB、5,000,000 行です。Enterprise でのデータセット・ファイル単位の上限は Pro と同じで、組織全体の上限は契約で決まります。プランの上限を超えると、新規アップロードだけが HTTP 402 quota_exceeded で拒否され、既存データは保持されます。Enterprise を含む全プランにはさらに 4 つの絶対上限があり、これらを超えると 402 ではなく HTTP 400 VALIDATION_ERROR です。ファイルが 64 MiB 超、データセットが 100,000 行超、地理ファイルが 50,000 フィーチャー超、画像オーバーレイが 16 MiB 超の場合です（GeoTIFF 自体ではなく、Studio が GeoTIFF から生成する画像のサイズ）。Studio のアップローダーに貼り付けた JSON はすべてのユーザーについて地図自体に保存され、これらの制限には算入されません。地図上のデータセット と エラー を参照してください。
  • データセットのアップロードが拒否されても地図には何も追加されません。 Studio はサーバーからの拒否をアップロード操作の横に表示し、ファイルを追加しません。プラン上限（402、サーバーメッセージと Upgrade Plan リンク付き）、サインアウト状態、権限不足、ファイルサイズ超過、アップロード過多、絶対上限超過の 400 など、あらゆる拒否が対象です。サーバーが応答しない、タイムアウトする、または障害を起こした場合に限り、データがプラン制限内なら警告を付けて行を地図内に保存します。それ以外では何も追加しません。アップロードに失敗した場合 を参照してください。
  • データパネルでデータセットを削除すると元に戻せません。 保存済みデータセットのゴミ箱操作で確認を求め、データセットとその地図レイヤーを削除し、組織全体の行数枠を解放します。公開地図と共有リンクからも提供されなくなります。同名ファイルをアップロードした場合は、新しいデータセットの保存完了時に以前のデータを置き換えます。新ファイルを読み込めなければ、地図は旧データに戻り、Studio が通知します。元に戻す操作で地図から削除済みデータセットへの参照が戻る場合もありますが、そのレイヤーは表示されません。データセットの削除・置換 を参照してください。
  • Studio の上限は組織の Kaleidr プランに従います。 組織が保持できる地図の数と上記データセット制限は、kaleidr.com/billing で購入・変更したプランで決まります。Kaleidr Studio 専用のプランはありません。
  • 公開地図と共有リンクには地図にアップロードしたデータが表示されます。 Studio のデータパネルで追加したデータセットはレイヤーとして、画像オーバーレイも埋め込みビューアーと共有リンクに描画されます。公開地図に含まれるデータだけが配信されます。データパネルでデータセットを削除すると、公開地図でもそのデータを表示していた共有リンクでも配信が止まります。地図の公開を停止すると埋め込みは動作しなくなりますが、配布済み共有リンクは以前のデータを使って引き続き機能します。ブラウザーは読み込み済みデータを保持し、発行済みダウンロードリンクは最長 1 時間利用できる場合があります。訪問者は全列を含むデータセット全体をダウンロードするため、大きい表は読み込みに時間がかかります。公開データセットは一般公開されます。公開地図にアップロードしたデータ を参照してください。
  • Studio から公開地図を非公開にできます。 公開中の地図には Publish & embed ページに Unpublish ボタンがあり、確認後に公開を停止します。すべての埋め込みには地図が利用できないことを示すメッセージが表示されます。地図 ID は変わらないため、再公開すると同じ埋め込み URL が復旧します。地図の公開停止 を参照してください。
  • Studio の AI アシスタントはデータセット全体について回答します。 開いている地図では、サンプルではなくアップロードしたデータセットの全行について、抽出、並べ替え、件数、合計、平均、グループ化、地点付近や範囲内の行の検索ができます。一度に扱うデータセットは 1 つで、結果は最大 100 行またはグループまで表示します。読み取りのみで、データを変更しません。データセットについて質問する を参照してください。
  • データセットには列の役割があります。 アップロード後、Studio は名前、カテゴリ、説明、住所の列を判定します。作成者はデータパネルの対象データセットにある Column Roles で修正できます。名前列は Studio の AI アシスタントや公開地図のチャットが各場所を呼ぶ名称になります。同名ファイルのアップロードでは新しいデータセットが保存され、以前の列が新ファイルにもあれば列の役割が引き継がれます。列の役割 を参照してください。
  • 地図固有の場所を使った回答が有効な場合、Visitor AI Chat は公開地図のアップロード済みデータセットから回答できます。 Kaleidr がプラットフォーム全体で有効化を管理し、デフォルトでは無効です。有効な場合、チャットが読み取る場所には、公開地図に含まれるデータセットの行も加わります。ただし、データセットに名前列があり、各行に点座標が必要で、地図 1 枚あたり 200 か所までです。地図固有の場所からの回答 を参照してください。
  • 組織がアップロードできる内容を報告する API が追加されました。 GET /shared-api/datahub/limits は事業者データのアップロード可否、組織のプランと上限を返します。すべてのプランで 200 を返し、Enterprise 未満では can_upload: false です。Studio でも同じ上限が 1 行で表示されます。組織のアップロード権限 を参照してください。
  • アップロードできないプランへの拒否は 403 vendor_data_not_on_plan です。 以前このドキュメントに記載されたコードに代わるもので、旧コードは返されません。旧コードを判定するクライアントを更新してください。
  • リリースの公開停止と削除ができます。 POST /shared-api/datahub/releases/{id}/unpublish は公開済みリリースを即座に停止し、DELETE /shared-api/datahub/releases/{id} は非公開リリースとその派生物を削除します。プランを下げた後を含め、どのプランの組織でも所有者・管理者が実行できます。Studio の Releases 一覧には Unpublish と Delete があり、Enterprise を離れた後もリリースを保持する組織の管理者に利用できます。リリース一覧には state と ingest_id が追加されました。リリースの取り下げ を参照してください。
  • 古いリリースは自動削除されます。 置き換え、公開停止、プレビュー期限切れで現行でなくなったリリースは、その時点から 30 日後に削除されます。失敗したリリースは最後の処理試行から 30 日後に削除されます。リリースの保持期間 を参照してください。
  • 列マッピングの提案は AI クレジットを消費します。 POST /inference-api/vendor/mapping/propose は組織の AI クレジットに課金し、不足時は 429 quota_exceeded を返します。アカウント当たり 1 時間に 30 回の提案制限は維持され、2 種類の 429 はレスポンス形式で区別できます。2 種類の 429 の見分け方 を参照してください。
  • vendor スコープは Enterprise 限定です。 Free と Pro のキーには付与できません。Free または Pro で vendor を指定してキーを作成すると 403 tier_capability_not_allowed が返されます。以前は Free では黙って除外され、Pro では作成できました。Enterprise 未満のプランで vendor 付きキーをローテーションすると、新しいキーからそのスコープが外されます。Enterprise からダウングレードすると、既存キーはエラーを出さずにデータへのアクセスを失い、既存のブラウザーセッションも終了します。Pro では引き続きサーバーキーとより多くの有効キーを使えます。認証とスコープ を参照してください。
  • Chat に言語、タイトル、プレースホルダーが指定できます。 新しいマウントオプションは lang、title、placeholder で、要素属性は lang、chat-title、placeholder です。lang を省略すると、有効なページの <html lang> 属性を使い、なければ英語になります。Chat リファレンス を参照してください。
  • <kaleidr-map> はデフォルトでブロック要素です。 CSS で変更しない限り display:block となり、height が適用されます。以前は別途 display:block を指定しないと高さが反映されませんでした。Safari 16.4 より前との互換性のため、例には display:block を引き続き記載します。サイズ設定 を参照してください。
  • マウント直後のハンドル呼び出しは保持されます。 Viewer と Tile では、フレーム内の地図が準備できる前の setCamera（Tile では setStyle も）は、準備完了時に適用されます。保持されるのは直近 256 回までです。以前は呼び出しが失われました。通常フレーム読み込みから 10 秒という限られた待機時間が過ぎても準備完了の通知がなければ、保持した呼び出しを警告を一度表示したうえで送信します。kaleidr-embed:ready を待つ必要はありません。
  • CDN のベース URL 上書きは 3 種類のオリジンだけを受け付けます。 base オプション・属性と window.__KALEIDR_EMBED_BASE__ は、Kaleidr CDN（https://cdn.kaleidr.com）、kaleidr.js を読み込んだオリジン、またはページ自身のオリジンに対してのみ有効です。それ以外はコンソール警告とともに無視され、デフォルト CDN が使われます。ローダーとバンドルを同じオリジンから配信すればセルフホスティングも可能です。CDN のバージョン管理 を参照してください。
  • 製品スクリプトはすべてのページで UTF-8 として読み込まれます。 ページの文字エンコーディング宣言に関係なく、ローダーが UTF-8 で読み込みます。以前は宣言のないページで Chat や Editor のマウントに失敗し、コンソールに chat.js loaded but window.KaleidrGeoChat is missing が出ることがありました。トラブルシューティング を参照してください。
  • destroy() の後に同じ要素へ再マウントしても安全です。 React の Strict Mode のように、最初のマウントが読み込み中でも問題ありません。
  • 拒否されたリクエストはクレジットを確保しません。 レート・同時実行制限、検証エラー、サイズ超過などで処理前に拒否されたリクエストは、AI クレジットも同時実行枠も保持しません。クォータとレート制限 を参照してください。
  • Viewer と Tile ではページ指定のカメラが優先されます。 読み込み時の center、zoom、pitch、bearing、iframe URL の camera、または setCamera で指定したカメラは、訪問者の画面幅やコンテンツに合わせて作成者が保存したビューより優先され、リサイズ時の自動再調整も終了します。ページが指定しない項目は作成者の値が維持され、読み込み時に center のない zoom だけを渡すと無視されます。カメラ を参照してください。
  • Viewer または Tile 要素の Chat はピンを保持します。 ほかの地図と同様に回答をまたいでピンが蓄積し、同じ場所が別の座標で再登場すると新しいピンを増やさず既存のピンを移動します。Chat を閉じるか破棄するとピン、経路、その他の描画物は削除されます。機能と制限 を参照してください。
  • Chat の title はパネルのタイトルです。 指定したタイトルは各会話が開始された後、チャットウィンドウのヘッダーに表示されます。以前は会話から生成されたタイトルに置き換わっていました。最小化したチャットはその会話のタイトルを表示します。タイトルとプレースホルダー を参照してください。
  • Editor は公開可能キーを使ってベースマップのリクエストを識別します。 kaleidr.js でマウントした Editor は、スタイル、スプライト、フォントを https://tile.kaleidr.com から取得するときにページの公開可能キーを送信します。セッショントークンが URL に入ることはありません。新しいオプションもありません。ページで動く内容 を参照してください。

API の制限と拒否​

  • Chat ストリームのリクエストには専用コード付きの制限があります。 422 too_many_messages、message_too_long、conversation_too_long、invalid_session_id、lang_too_long。エンドポイント を参照してください。
  • 要約とボタンのストリーム は長すぎるフィールドを 422 field_too_long で拒否します。
  • 2 MiB を超えるリクエスト本文（設計エンドポイントは 5 MiB）は 413 request_too_large で拒否します。
  • 完了せずに終了した Chat ストリーム には、少なくとも送信した会話のサイズに応じて課金されます。
  • セッショントークンには表示されない情報があります。 セッショントークンの 429 quota_exceeded 本文と quota ストリームイベントには、プラン、使用量、上限が含まれなくなりました。
  • サーバーキーや旧キーの製品制限 は各リクエストで確認され、403 product_not_allowed が返されます。
  • 事業者データのアップロード にはフィールド・リスト単位の制限と、413 request_body_too_large、409 org_ingest_in_progress、429 ingest_rate_limited が追加されました。列マッピングの提案を呼び出せるのは、アップロード権限のある Enterprise 組織の所有者または管理者だけです。事業者データのアップロード を参照してください。
  • Kaleidr Studio のデータセットアップロード は、プランの上限を超えると 402 quota_exceeded、全プラン共通の絶対上限を超えると 400 VALIDATION_ERROR になります。エラー を参照してください。

これらのページの訂正​

以下の各項目は、製品が変更されたのではなく、従来のドキュメントに誤りがあった箇所です。

エラーコードとステータス

  • AI クレジットの枠を超えるリクエストは 429 と "error": "quota_exceeded" を返します。以前の記載にあった b2b.tokens_exceeded は API が一度も返したことのないコードです。本文にも detail、product、period が抜けていました。
  • map_load_hard_stop というコードはありません。以下の「プラン」を参照してください。
  • キーの許可オリジン外からセッション交換すると 403 origin_not_allowed が返されます。以前に記載された session_origin_mismatch は、セッショントークンを発行元と異なるオリジンで使用した場合のコードです。
  • vendor_scope_requires_acknowledgement は 403 ではなく 422 で、公開可能キーにだけ適用されます。
  • sessions_disabled は 404、sessions_not_configured は 503 です。以前は両方 403 でした。
  • 401 の本文は {"detail": "Invalid or missing API key"} です。以前は本文がないと記載されていました。
  • map_load_quota_exceeded は {"detail": "map_load_quota_exceeded"} という形で返されます。以前のフラットな例は存在しません。
  • キーサービスの障害では 503 ではなく 401 が返ります。
  • Viewer 埋め込みにキーを渡しても product_not_allowed にはなりません。Viewer にキーは不要です。
  • 不足していた visitor_limit_reached、chat_disabled、not_found、owner_has_no_organization、org_admin_required、key_not_found、key_already_rotated などのコードが記載されました。
  • 編集時の key_already_rotated と key_expired は expires_at のみについて適用され、キーのほかの項目は引き続き編集できます。すでに取り消したキーを再度取り消すと 200 です。
  • 拒否コードの格納場所。 403 と 404 のコードは detail にあります。プラットフォーム API の 429 は error にコード、detail に説明文を含みます。ただし map_load_quota_exceeded は例外で、detail に格納されます。アップロード API の 429 は レスポンス形式 を参照してください。

完全な一覧はエラーを参照してください。

プラン、クォータ、キー

  • 独自データに基づく回答 は以前「Pro 以上」とされていましたが、事業者データの AI 回答への利用は Enterprise 限定です。アップロードも、API または SDK から読み込む vendor スコープも対象です。Free と Pro には別の機能として Kaleidr Studio の地図に追加するデータセットがあります。上の「製品変更」を参照してください。
  • どのプランでも地図読み込みは上限で停止します。 有料プランでは上限の 5 倍まで継続できるという以前の説明は誤りです。地図読み込みパックを購入すると上限が増えます。
  • AI クレジットは組織ごとに共通のプールです。 API キーとチームの Kaleidr アプリ利用で共有します。以前の独立した月間 API トークン予算という説明は誤りでした。
  • クォータ期間は請求期間であり、必ずしも暦月ではありません。
  • レート制限はキー単位、同時実行は組織単位です。キー間でレート制限が共有されるという記載は誤りでした。
  • 公開可能キーでは許可オリジンのリストは省略可能です。以前は Live キーには 1 件以上必要とされていましたが、空リストは全オリジンを許可します。
  • キー作成後にスコープは編集できません。 変更・削除できるという記載は誤りです。新しいキーを作成し古いキーを取り消してください。
  • サーバーキーと旧キーは実行時の呼び出しへ直接渡します。全呼び出しにセッショントークンが必要という説明は誤りです。
  • Free でのローテーション。 Free で公開可能キーをローテーションすると、旧キーの設定に関係なく Free の全機能（ai、maps、design と 4 製品）が付与されます。Free でのサーバーキー・旧キーのローテーションは 403 free_plan_publishable_only で拒否されます。
  • monthly_cap_tokens： 1 以上で上限を設定し、0 または null なら上限なしです。
  • キー作成時の org_id は JSON 本文に入れます。ほかのキー操作ルートだけがクエリの org_id を読み取ります。
  • Visitor AI Chat はすべてのリクエストを数えます。 1 回の質問で回答リクエストが 1 件、結果カード 1 件につき写真リクエストが 1 件発生します。カードを開く、追加質問をする、経路検索で住所を調べる、ルートを求める操作もすべて訪問者制限に算入されます。公開地図の Chat を参照してください。

クォータとレート制限および認証とスコープを参照してください。

ストリーミング

  • quota は end または error の後に送られるストリームの最後のイベントです。途中に到着するという以前の記載は誤りでした。使用量を報告するもので、終了前の警告にはなりません。
  • place イベントは 座標なしで到着し、unverified: true と表示されることがあります。
  • error イベントの code は upstream_stall の場合だけ付与されます。
  • weather_card、building_card、arrivals_card などのカード・レイヤーイベントが記載されました。
  • 要約ストリームとボタンストリームの仕様が追加されました。
  • セッショントークンの quota イベント には type、meter、reset_at だけが含まれます。以前の使用量数値入り例はサーバーキーに限られます。
  • end が繰り返すカード・レイヤーイベントは 5 つだけです。 weather_card、satellite_card、constellation_layer、weather_layer、vehicles_layer で、すべての種類ではありません。

SSE ワイヤー仕様を参照してください。

エンドポイント

  • POST /design/analyze と POST /design/apply-direct のリクエスト本文の記載は誤りでした。以前の解析例は 422 を返していました。両方とも修正され、カタログのレスポンスは外側のキー付きで示されています。
  • POST /chat/control/route の各場所には、coordinates の中ではなく直下に lat と lng を指定します。
  • POST /chat/control/stream に送信した system メッセージは無視されます。この点が以前は未記載でした。

エンドポイントを参照してください。

公開マップと共有リンク

  • 公開地図は現在保存されている状態を表示します。 埋め込みは「最後に公開したバージョン」を表示し、Re-publish で更新するという以前の説明は誤りでした。Studio で保存した変更は、データセットの追加も含め、再公開しなくても次の埋め込み読み込みで公開されます。Re-publish は新しい公開版を記録しますが、ID、リンク、埋め込みコードは同じです。非公開で編集するには、先に公開を停止し、編集完了後に再公開してください。地図の埋め込み を参照してください。
  • Studio では共有リンクを削除・一時停止できません。 Share ダイアログを開くと地図が公開され、毎回新しいリンクが作成されます。共有リンクは地図デザインのスナップショットで、地図の公開停止後も、地図が削除されるか Kaleidr が依頼に応じてリンクを取り下げるまで動作します。以前の削除・一時停止の説明は実際の画面にはありません。共有リンク を参照してください。

SDK と埋め込み

  • Chat は地図を移動します。 以前はカメラを操作しないと書かれていましたが、実際は回答中の場所に移動・範囲調整し、専用ピンとルートを描画します。Chat のマウントハンドルにある setCamera だけは未対応です。
  • Editor の機能範囲。 埋め込み Editor はページ内で動作し、作業はページメモリ上に保持されます。保存、エクスポート、公開はできず、設計 API も呼び出しません。埋め込みから公開できるという以前の記載は誤りです。
  • Content Security Policy のホスト。 Editor はベースマップを https://tile.kaleidr.com から読み込みます。このホストは以前のポリシーにありませんでした。デフォルトで第三者の地図ホストへ接続する埋め込みはありません。Chat は引用サイトのアイコンを Google の favicon サービスから読み込むため、ポリシーと 機能と制限 に記載されました。
  • Leaflet が Chat 対応の地図として再び記載されました。 Mapbox GL JS、MapLibre GL JS、Google Maps JavaScript API とともにサポートされます。
  • Tile フレームの URL には認証情報がありません。 スタイル ID とカメラだけが含まれ、公開可能キーやセッショントークンは含まれません。Tile のセッション交換はキーを確認し、地図読み込みを数え、組織のデフォルト地図を返します。フレーム内の地図はその認証情報で呼び出しを行いません。Tile リファレンス を参照してください。
  • Kaleidr.enable(false) が保留するのは呼び出し以降のマウントだけです。 ローダー実行時にブラウザーが既に読み取っていた <kaleidr-map> 要素は、呼び出し前に直ちにマウントされます。ローダーより先に window.__KALEIDR_EMBED_ENABLED__ = false を指定してください。
  • オプションオブジェクトなしの Kaleidr.mount は TypeError をスローします。 それ以外の失敗したマウントは [kaleidr:<product>] を含むコンソールエラー（Error: [kaleidr:… と表示）を一度記録し、例外をスローしません。
  • 埋め込み Editor のツール欄 には Text、Image、Marker、Popup、Background、Layer、Design、Legend があります。Design がないという以前の記載は誤りで、実際にないのは Studio のデザインカタログ、Data タブ、AI パネル、3D モデルライブラリです。
  • kaleidr-plain はズーム 15 以降で 3D 建物を表示します。 以前はないと書かれていました。
  • スタイルの指定がなく組織のデフォルトもない Tile は kaleidr-embed:error を code: 'no_id' と id: null 付きで送信します。
  • Viewer の shareId には公開地図 ID または共有リンクの 16 文字 ID を指定できます。公開地図の Chat では地図自体の ID だけを指定できます。

新しいページ​

2026-10​

  • 住所結果の情報が増えました。 GET /retrieval/geocode/forward の住所結果には、データ更新後も変わらない Kaleidr の入口識別子 id が付与されます。推定住所には method、matched_numbers に加えて within_m と score が付きます。method は "range" の場合があり、米国の住居番号を対応する街区に沿って配置したことを示します。すべて追加項目です。エンドポイント を参照してください。
  • Free プランの API キー。 Free 組織の公開可能キーは、ベースマップに加えて AI チャット、公開地図、Editor にも対応しました（ai、maps、design スコープと全製品）。Free の AI クレジットを使用します。サーバーキーは Pro または Enterprise が必要です（vendor スコープは 2026-10-13 から Enterprise 限定）。組織ごとの有効キー数は Free 2、Pro 10、Enterprise 25 です（超過時は 409 key_limit_reached。ローテーションは数えず、既存の超過キーは保持されます）。

2026-09​

  • 住所検索で番地付き住所に対応しました。 GET /retrieval/geocode/forward は入力された番地付き住所（type: "address"）も返します。attribution.sources に利用した住所データセット、その出典とライセンス上の利用制限が記載されます。G-NAF の結果を郵送先住所一覧の作成に使うことはできません。未登録の番地は同じ通りの近隣番号から推定し、approximate: true、method、matched_numbers を付けます。場所検索の結果は従来どおりです。
  • 公共交通の経路案内。 POST /chat/control/route は profile: "transit" に対応し、乗り換えなしの経路を action.payload.transit に返します。直行便がない場合は { "error": "…" } を返します。リクエスト本文とその他の profile の動作は従来どおりです。新しい GET /retrieval/geocode/forward（スコープ ai、有料）が出発地・目的地検索を提供します。Chat の経路案内画面には入力可能な From/To フィールドと Transit モードが加わりました。
  • キーが使える機能は現在のプランに従います。 セッション交換と実行時呼び出しのたびに組織のプランを確認するため、キーの編集・ローテーションなしでプラン変更が反映されます。tier_capability_not_allowed はキーには権限があるが現在のプランにはなく、insufficient_scope はキーが一度も権限を持っていないことを示します。
  • プラン変更は発行済みセッションにも反映されます。 ダウングレード後、既存セッションは有効期限を待たず数分以内に終了します。アップグレードは次回のセッション交換から適用されます。
  • Free プランの製品制限の編集がチェックされます。 Free キーの allowed_products を空リストかプラン外の製品にすると 403 tier_capability_not_allowed です。
  • ストリームイベント grounding が削除されました。 これを待っていたクライアントには届かなくなりました。

2026-08​

  • ベースマップへのアクセスにはキーが必要です。 tile.kaleidr.com を第三者が直接使うことは制限されますが、<kaleidr-map> 埋め込みや Kaleidr ホスト地図は影響を受けません。Tile セッションは組織の地図読み込みに数えられます（クォータ）。
  • セッション交換と更新。 公開可能キーは、オリジンに結び付いた短期間のセッション（kld_sess_…、15 分）と交換され、SDK が更新します。
  • Chat は Kaleidr の地図要素を操作できます。 Chat のマウントで map-target を同じページの Viewer または Tile 要素に指定できます。
  • 組織のデフォルトベースマップ。 POST /sdk/sessions は組織のデフォルトを basemap_style_id として返し、スタイル未指定の埋め込みはこれを使います。
  • ブラウザーではサーバーキーを拒否します。 SDK はマウント時に kld_sk_… を拒否します。
  • ベース指定オプションの分離。 viewerBase と tileBase はローダーの base から分離されました。
  • ルートの色。 route ストリームイベントには color、label、alternatives、comparison が含まれます。

v1​

  • kaleidr.js ローダーと <kaleidr-map> 要素：1 つのローダーで 4 製品（Chat、Viewer、Editor、Tile）に対応します。
  • ai、maps、design、vendor スコープ付きのブラウザー公開可能キー（kld_pk_）とサーバーキー（kld_sk_）。公開可能キーはオリジンに結び付いた短期間のセッションと交換されます。旧式の kld_live_ キーも引き続き使用できます。
  • /inference-api/b2b/v1/chat/*（ストリーミング）および /design/* のエンドポイント群。