概要
Maps Platform のエージェント型 UI ツールキットは、会話型 AI の時代に合わせて特別に設計されたデベロッパー ツールキットです。LLM システムの指示と UI コンポーネントのライブラリが用意されており、大規模言語モデル（LLM）と AI エージェントが地理空間データのリアルタイムのインタラクティブな視覚的レスポンスを構築するのに役立ちます。
ビジュアル要素をハードコードする代わりに、ツールキットを使用して LLM からの「インテントベースの指示」を動的なコンテキスト認識型の地図や場所の表示に変換し、ユーザーをチャット機能に引き込むことができます。
一般的なユースケースには次のものがあります。
- AI アシスタント: ローカル クエリ（ホテル、レストランなど）のテキスト レスポンスを視覚的なコンテキストで補強します。
- 旅行プランナー: 地図、ルート、場所の詳細をインラインで表示します。
- ローコード開発: ウェブとモバイルのタッチポイントで複数の Maps API を手動でオーケストレートする際の摩擦を軽減します。
主なコンセプト
1. エージェント対応 UI
リアルタイムの LLM を活用したエクスペリエンス向けに特別に設計された、スケーラブルで高品質なビジュアル（場所カード、没入型地図ビュー、ルートのプレビューなど）を有効にします。
2. コンテキスト リッチなエクスペリエンス
ユーザーがチャットを離れることなく、情報を確認して判断できるようにします。写真ギャラリー、評価、ルート オプションなどの豊富なインライン マップのコンテキストを提供することで、ユーザーの関心を維持し、行動を起こす自信を与えます。
3. インテリジェント コンポーネント
エージェント UI ツールキットは、複雑な地理空間ロジックを自動的に処理し、コンテキストとレイアウトをユーザーの意図に合わせて瞬時に調整します。また、スタイリングにより、すべてのインタラクションがブランドと関連付けられているように感じられます。
4. LLM 非依存
エージェント UI ツールキットは、AI スタックに依存しません。Gemini、OpenAI、Anthropic のモデルを使用する場合でも、グラウンディングされたデータソースに関係なく、Agentic UI ツールキットは位置データを可視化するための専用のプレゼンテーション レイヤを提供します。
5. サーバーサイド テンプレートのアーキテクチャ
サーバーサイド テンプレート アーキテクチャは、サーバーサイドでテンプレートの展開とパラメータの解決を行うことで、コンポーネントのレンダリングを高速化します。これにより、リアルタイムの会話エクスペリエンスのレイテンシが大幅に改善されます。
スタートガイド
Agentic UI ツールキットの使用を開始するには、Google Gemini API キーと Google Maps Platform API キーを使用して初期化する必要があります。
詳しい手順については、スタートガイドをご覧ください。
UI の成果
エージェント型 UI ツールキットは、すぐに使える特殊な UI 機能の包括的なスイートを提供します。これらのコンポーネントは、ウェブ、Android、iOS で利用できます。
- Place Detail（Compact）: コンパクトなカードに表示される特定の POI 情報。
- インライン マップ: ポイントまたはエリアのロケーター。
- インラインの地図とルート: ナビゲーションまたは経路のプレビュー。
- インライン地図の詳細: 豊富な画像を使用した場所の雰囲気やコンテキスト。
システム指示
エージェント UI ツールキットは、「システム指示」を提供して、UI をいつ、どのように構築するかについてホスト LLM をガイドします。
ガイドライン
ホストモデルは次のことを理解する必要があります。
どのコンポーネントがどのユーザー インテントと一致するか（例: 方向に関するクエリにはインライン地図を使用）。
自然言語からスキーマへのパラメータ マッピング（例: ユーザーが「景色の良い」と尋ねた場合、地図モードを衛星に設定）。
ツールの使用スキーマ
Agentic UI ツールキットは、標準の LLM ツール使用スキーマ（関数呼び出しなど）と互換性のある定義のカタログを公開します。
ポリシーと利用規約
このライブラリは Google Maps Platform サービスを使用します。このライブラリを介した Google Maps Platform サービスの利用には、Google Maps Platform の利用規約が適用されます。Grounding Lite や Google マップによるグラウンディングなど、一部の API とバックエンド サービスには、追加の利用規約要件があり、それらも満たす必要があります。
このライブラリは Google Maps Platform コアサービスではありません。そのため、Google Maps Platform 利用規約（テクニカル サポート サービス、サービスレベル契約、非推奨ポリシーなど）は、このライブラリのコードには適用されません。
サポート
このライブラリはオープンソース ライセンスを通じて提供されます。Google Maps Platform テクニカル サポート サービス ガイドライン、SLA、非推奨ポリシーは適用されません。ただし、ライブラリで使用される Google Maps Platform サービスには、引き続き Google Maps Platform 利用規約が適用されます。
Google マップのソースの帰属表示の要件
Agentic UI ツールキットからの各ツール レスポンスには、ソースが含まれています。ツールキットで提供されるツールを使用して結果を表示する場合は、次の要件を満たす方法で、関連する Google マップのソースを含める必要があります。
- Google マップのソースは、ソースがサポートする生成コンテンツの直後に示す必要があります。
- Google マップのソースは、1 回のユーザー操作で表示できる必要があります。
フィードバックの共有
Google マップ エージェント型 UI ツールキットに関するフィードバックを送信するには、次のフォームを使用します。