地図認識AIアシスタントの構築方法

地図認識AIアシスタントは、ビューポート、選択地点、フィルター、許可済み位置などの構造化された地図コンテキストを使って質問を解釈し、根拠ある回答と地図操作を返す対話インターフェースです。マーカー配置、結果の表示範囲調整、地域の強調、ルート要求、選択地物へのフォーカスが可能です。責任は4つに分けます。ホストは状態と権限、信頼できるシステムは事実、空間ツールは地理計算を所有し、AI層は意図を解釈して対応済み操作を提案します。

以下では共有状態、操作語彙、レンダラーアダプター、Kaleidr Chatの接続、根拠付け、一般的な誤りを説明します。製品情報はKaleidr Spatial AIをご覧ください。SDK構成はAI地図SDKとは？、レンダラーマウントはMapbox、Google Maps、MapLibre上のAIチャット、認証情報と非公開レコードは地図API認証とAI地図ワークフローの非公開位置データを参照してください。

アシスタントの要点

ピクセルではなく状態を共有： 境界、選択ID、フィルター、結果IDを渡し、モデルに画像として地図を読ませません。

ビューポートはコンテキスト： ユーザーがこの範囲の検索を求めた場合を除き、可視境界はランキングに影響させます。

意味的操作のみ： show_placesやfit_placesを出力し、レンダラーJavaScriptは出力しません。

発生元をタグ付け： ユーザーのパンとアシスタントのカメラ移動でモデルを再起動させません。

事実を根拠付け： 営業時間、同一性、形状、移動時間は権威あるシステムから取得します。

共有地図状態、信頼できる位置データ、空間ツールを用いて、根拠ある回答と同期された地図操作を返す地図認識AIアシスタント。

地図認識AIアシスタントは何が違いますか？

地図の横にあるテキスト専用アシスタントは、パリがフランスにあると知っているかもしれません。地図認識製品は、中心、可視境界、ズーム、選択地物、フィルター、現在のルート、以前の結果、許可済み位置、ホストアプリ状態など、ユーザーが地図上で何をしているかも把握します。「この中でホテルに一番近いのは？」は契約なしでは曖昧です。「この中」は現在の結果、「ホテル」は選択ホテルまたはセッションの起点、「一番近い」は距離または移動時間の計算を指します。有用な出力には回答、選択地点、地図フォーカス、理由が含まれます。

従来の地図検索はカテゴリ、半径、営業中などの構造化コントロールから始まります。「この周辺で、顧客との会議に使え、静かで19時以降も開いているカフェ」のように固定フィルターにしにくい条件を混ぜる場合、会話が役立ちます。AIはカテゴリ、地域、好み、時間、用途を解釈します。場所の同一性、営業時間、形状、移動時間、経路、適格性は引き続き決定論的システムが担当します。モデルは要求の解釈に使い、地理的事実の唯一の情報源にはしません。

機能	地図横のテキストアシスタント	地図認識AIアシスタント
自然言語を理解	はい	はい
可視範囲を把握	必ずしも把握しない	提供時は把握
選択地点を把握	必ずしも把握しない	はい
現在のフィルターを使用	通常しない	可能
地図操作を適用	通常は限定的	はい
ホスト状態を共有	弱い	明示的

共有地図状態をどう設計しますか？

本番ループは、質問、ホストコンテキストのスナップショット、意図解釈、認可済み検索、空間計算、根拠ある回答、検証済み操作、レンダラー更新です。モデルが画面を推測することを期待せず、明示的な状態契約から始めます。選択地物ID、現在の結果ID、関連フィルター、必要な場合の可視境界、ルートコンテキスト、許可済み起点、状態バージョンなど、タスクに必要な情報だけを含めます。選択地点は古い結果一覧より優先し、ユーザー指定の目的地は既定起点より優先する、といった順位を決めます。

ビューポートを隠れたハードフィルターにしないでください。可視境界はカメラ外を黙って除外せず、結果の順位や重み付けに利用できます。「2番目のカフェ」がパン後も同じレコードを指すよう、会話間で安定した場所IDを維持します。同一性と生成説明を分離し、ホストがplace_idとソース項目を保存します。モデルは適合理由を説明できますが、新しい識別子を作ってはいけません。

双方向状態は一方向チャットより堅牢です。パン、ズーム、選択、フィルターはユーザーイベントとしてタグ付けされたホストストアを更新します。場所表示、結果範囲調整、場所を開く、ルート表示などは検証とアダプターを通り、アシスタントイベントとしてタグ付けされます。次のターンで必要な場合だけ新しいスナップショットをモデルへ返します。ループガードにより、アシスタントのカメラ移動が自動的に次のモデル要求を始めないようにします。

ユーザー操作と検証済みAI地図操作が1つのホスト状態を更新し、発生元タグがフィードバックループを防ぐ双方向構成。

地図操作をレンダラー非依存にするには？

場所表示、場所の範囲調整、場所を開く、地物の強調、ルート表示、結果消去という小さな操作語彙を設計します。各操作をスキーマ検証し、オブジェクト権限を確認してから、アダプター内で意味カードをMapbox、Google Maps、MapLibreの呼び出しへ変換します。任意のJavaScriptをモデルに出力させません。OWASPの2025年プロンプトインジェクション指針は、検索または会話内容がツール動作を変更しようとする可能性を指摘しています。操作されたモデルでも未承認コードや未認可オブジェクトにアクセスできない設計が必要です。

一時的なAI結果レイヤーと永続ホストデータを分け、会話を消去しても保存地点を削除しないようにします。結果なしや曖昧さには、偽のマーカーではなく明示的な空集合と追加質問で対応します。ランキングは認可済み項目から説明できるようにします。アシスタントがカメラ移動を提案しても、その後のユーザーパンを優先します。会話応答はトークンをストリームし、場所解決後までカメラ移動を遅らせて、部分回答中のジャンプを防ぎます。

構造化AI地図操作が検証とレンダラーアダプターを通り、Mapbox、Google Maps、MapLibre操作に変換される様子。

Kaleidr Chatを既存地図に接続するには？

現在のChat文書では、SDKを動作中のMapbox、MapLibre、Google Maps、Leaflet地図に接続し、解決した場所を描画して、会話が位置を解決するにつれカメラを調整できます（Chat attach）。ホストは地図を描画し続け、Chatが対話型空間レイヤーを追加します。Mapbox、Google Maps、MapLibre向けガイドがあります。ブラウザーはaiスコープの公開可能キーを使い、オリジンに紐づく短期セッションと交換します（Auth & Scopes）。ヘッドレスモードはテストやチャット専用UI向けにmapを省略します。現在のkaleidr.jsを読み込み、ライブ地図オブジェクトの作成後にマウントします。

// myMap must already be a live supported map instance
const chatHandle = Kaleidr.mount("#map-chat", {
  product: "chat",
  publishableKey: "kld_pk_live_REPLACE_ME",
  map: myMap,
  enabled: true
});

非公開業務データはホスト認可と最小限の検索の背後に置きます（Endpoints）。ユーザー位置はオプトインにします。不要な精密座標や会話ログをブラウザーや分析へ送りません。権限判断ではなく安定した公開事実をキャッシュします。チャット回数だけでなく、場所選択、経路を開く、物件候補作成などの位置タスク完了を計測します。公開前に共有状態の競合、地理的曖昧さ、悪意ある操作ペイロードをテストします。

ホストアプリ、信頼できる場所データ、空間エンジン、AIアシスタントが根拠ある地図結果を生成する責任境界。

避けるべき誤りは何ですか？

誤り	リスク	より良い方法
状態を知らない地図の横にテキスト助手を置く	「これ」「ここ」が曖昧	構造化地図状態を共有
ビューポートを無言のフィルターにする	有効な近隣結果を見逃す	要求時以外は境界をコンテキストにする
モデルにレンダラーJavaScriptを出力させる	インジェクションとベンダーロックイン	意味的操作 + アダプター
カメラ移動ごとにモデルを再起動	ループとコスト	発生元タグ + ループガード
文中で場所IDを作る	重複または偽レコード	信頼データの安定ID
最初のトークンでカメラを動かす	不安定な地図	場所解決を待つ
AIレイヤーと保存データを混在	誤削除	一時結果レイヤーを分離
サーバーキーをブラウザーへ送る	認証情報の窃取	公開可能キー + `ai`スコープ
結果なし状態を省略	偽マーカー	空集合 + 追加質問
チャット量だけ計測	見せかけの指標	地図上のタスク完了

最終結論

地図認識AIアシスタントは、会話とライブ地図が明示的な状態・操作契約を共有すると機能します。ホストは権限とレンダラー呼び出し、信頼できるシステムは同一性と運用事実、空間エンジンは距離、経路、形状を所有します。モデルは境界内で意図を解釈し、ランキングを調整し、結果を説明します。Kaleidr Chatは現在、公開可能ブラウザーキーとMapbox、Google Maps、MapLibreガイドを使い、ホストが描画する地図に会話レイヤーを接続します。状態契約を先に作り、チャットパネルは最後の画面と考えてください。

既存地図にAIチャットを追加する

Kaleidr Chatを動作中のMapbox、Google Maps、MapLibre、Leaflet地図へ接続し、ホストを正規レンダラーとして維持します。マウント、ヘッドレステスト、現在のキースコープは**Kaleidr Chat文書**をご覧ください。

よくある質問

地図認識AIアシスタントとは？

選択地点、可視領域、フィルター、起点などの構造化コンテキストを受け取り、根拠ある結果と対応済み地図操作を返す対話インターフェースです。

テキスト専用アシスタントとの違いは？

テキスト助手は主に文章を交換します。地図認識助手は地図と状態を共有し、地理検索、空間計算、マーカー、カメラ、ルート、選択を調整します。

AIは地図を画像として読むべきですか？

アプリ状態については通常不要です。境界、地物ID、フィルター、結果IDを提供します。視覚理解が役立つ別用途はありますが、状態は明示します。

ビューポートは常に検索結果を制限すべきですか？

いいえ。ハードフィルターではなくコンテキストにできます。「この範囲を検索」が明示された場合だけ境界にします。

アシスタントが知るべき状態は？

選択地物、結果ID、関連フィルター、必要時の可視境界、ルートコンテキスト、許可済み起点など、現在のタスクに必要なものだけです。

AIはどう地図を制御すべきですか？

show_places、fit_places、open_place、show_routeなどの小さな構造化語彙を検証し、ホストで変換します。

モデルはMapboxやGoogle MapsのJavaScriptを出力すべきですか？

主要な制御方法としては不可です。意味的操作のほうが安全でレンダラー非依存です。

非公開業務データを使えますか？

ホストが認証し、テナント、オブジェクト、項目権限を適用し、必要な認可済みレコードだけを取得する場合は可能です。

Kaleidr Chatは既存地図に接続できますか？

はい。Mapbox、MapLibre、Google Maps、Leafletのライブ地図へ接続し、場所描画とカメラ調整ができます。

Kaleidr Chatはレンダラーを置き換えますか？

いいえ。ホストが描画を続け、Chatは対話型空間レイヤーを追加します。

ブラウザーではどのキーを使いますか？

aiスコープの公開可能キーを使い、オリジンに紐づく短期セッションへ交換します。

地図なしでも動作しますか？

会話レイヤーは動作します。mapを省略するヘッドレスモードはテストやチャット専用UIに便利です。

どう計測すべきですか？

場所の選択・保存、経路を開く、物件候補、店舗選択、予約完了など、ユーザーが有用な位置タスクを完了したかを測ります。

参考資料

Kaleidr. AI Maps You Can Talk To — Spatial AI. 2026年8月20日参照。 https://kaleidr.com/ai
Kaleidr. Attach Kaleidr AI to a Google Map. Kaleidr Developer Docs. 2026年8月20日参照。 https://docs.kaleidr.com/guides/attach-ai-to-google-maps
Kaleidr. Attach Kaleidr AI to a Mapbox Map. Kaleidr Developer Docs. 2026年8月20日参照。 https://docs.kaleidr.com/guides/attach-ai-to-mapbox
Kaleidr. Attach Kaleidr AI to a MapLibre Map. Kaleidr Developer Docs. 2026年8月20日参照。 https://docs.kaleidr.com/guides/attach-ai-to-maplibre
Kaleidr. Auth & Scopes. Kaleidr Developer Docs. 2026年8月20日参照。 https://docs.kaleidr.com/platform-api/auth-and-scopes
Kaleidr. Chat — Attach AI to Your Map. Kaleidr Developer Docs. 2026年8月20日参照。 https://docs.kaleidr.com/sdk/chat-attach
Kaleidr. Endpoints. Kaleidr Developer Docs. 2026年8月20日参照。 https://docs.kaleidr.com/platform-api/endpoints
Kaleidr. kaleidr.js — the Loader. Kaleidr Developer Docs. 2026年8月20日参照。 https://docs.kaleidr.com/sdk/kaleidr-js
Google. Load the Maps JavaScript API. Google Maps Platform documentation. 2026年8月20日参照。 https://developers.google.com/maps/documentation/javascript/load-maps-js-api
Mapbox. Get started with Mapbox GL JS using a CDN. Mapbox GL JS documentation. 2026年8月20日参照。 https://docs.mapbox.com/mapbox-gl-js/guides/get-started/use-with-cdn/
MapLibre. Display a map. MapLibre GL JS documentation. 2026年8月20日参照。 https://maplibre.org/maplibre-gl-js/docs/examples/display-a-map/
OWASP Gen AI Security Project. LLM01:2025 Prompt Injection. 2026年8月20日参照。 https://genai.owasp.org/llmrisk/llm01-prompt-injection/

@misc{kaleidr_chat_attach_2026,
  title  = {Chat -- Attach AI to Your Map},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Docs; accessed 20 August 2026},
  url    = {https://docs.kaleidr.com/sdk/chat-attach}
}

@misc{kaleidr_spatial_ai_2026,
  title  = {AI Maps You Can Talk To -- Spatial AI},
  author = {{Kaleidr}},
  note   = {Accessed 20 August 2026},
  url    = {https://kaleidr.com/ai}
}

@misc{kaleidr_auth_scopes_2026,
  title  = {Auth and Scopes},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Docs; accessed 20 August 2026},
  url    = {https://docs.kaleidr.com/platform-api/auth-and-scopes}
}

@misc{kaleidr_attach_mapbox_2026,
  title  = {Attach Kaleidr AI to a Mapbox Map},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Docs; accessed 20 August 2026},
  url    = {https://docs.kaleidr.com/guides/attach-ai-to-mapbox}
}

@misc{kaleidr_attach_google_2026,
  title  = {Attach Kaleidr AI to a Google Map},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Docs; accessed 20 August 2026},
  url    = {https://docs.kaleidr.com/guides/attach-ai-to-google-maps}
}

@misc{kaleidr_attach_maplibre_2026,
  title  = {Attach Kaleidr AI to a MapLibre Map},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Docs; accessed 20 August 2026},
  url    = {https://docs.kaleidr.com/guides/attach-ai-to-maplibre}
}

@misc{kaleidr_endpoints_2026,
  title  = {Endpoints},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Docs; accessed 20 August 2026},
  url    = {https://docs.kaleidr.com/platform-api/endpoints}
}

@misc{kaleidr_js_loader_2026,
  title  = {kaleidr.js -- the Loader},
  author = {{Kaleidr}},
  note   = {Kaleidr Developer Docs; accessed 20 August 2026},
  url    = {https://docs.kaleidr.com/sdk/kaleidr-js}
}

@misc{google_maps_js_loader_2026,
  title  = {Load the Maps JavaScript API},
  author = {{Google}},
  note   = {Google Maps Platform documentation; accessed 20 August 2026},
  url    = {https://developers.google.com/maps/documentation/javascript/load-maps-js-api}
}

@misc{mapbox_cdn_guide_2026,
  title  = {Get started with Mapbox GL JS using a CDN},
  author = {{Mapbox}},
  note   = {Mapbox GL JS documentation; accessed 20 August 2026},
  url    = {https://docs.mapbox.com/mapbox-gl-js/guides/get-started/use-with-cdn/}
}

@misc{maplibre_display_map_2026,
  title  = {Display a map},
  author = {{MapLibre}},
  note   = {MapLibre GL JS documentation; accessed 20 August 2026},
  url    = {https://maplibre.org/maplibre-gl-js/docs/examples/display-a-map/}
}

@misc{owasp_llm01_prompt_injection_2025,
  title  = {LLM01:2025 Prompt Injection},
  author = {{OWASP Gen AI Security Project}},
  note   = {Accessed 20 August 2026},
  url    = {https://genai.owasp.org/llmrisk/llm01-prompt-injection/}
}