概要
Maps Platform のエージェント型 UI ツールキットは、会話型 AI の時代に合わせて特別に設計されたデベロッパー ツールキットです。LLM システム指示のセットと UI コンポーネントのライブラリが用意されており、大規模言語モデル（LLM）と AI エージェントが地理空間データに対してリアルタイムでインタラクティブな視覚的レスポンスを構築するのに役立ちます。
ビジュアル要素をハードコーディングする代わりに、このツールキットを使用して、LLM からの「インテントベースの指示」を動的でコンテキストを認識する地図と場所の表示に変換し、ユーザーがチャット エクスペリエンスに集中できるようにします。
一般的なユースケースは次のとおりです。
- AI アシスタント: ホテルやレストランなどのローカルクエリに視覚的なコンテキストを追加して、テキストによる回答を補完します。
- 旅行プランナー: 地図、ルート、Place Details をインラインで表示します。
- ローコード開発: ウェブとモバイルのタッチポイントで複数の Maps API を手動でオーケストレートする際の摩擦を軽減します。
主なコンセプト
1. エージェント対応 UI
リアルタイムの LLM を活用したエクスペリエンス向けに特別に設計された、プレイスカード、没入型マップビュー、ルート プレビューなどのスケーラブルで高品質なビジュアルを作成します。
2. コンテキストが豊富なエクスペリエンス
ユーザーがチャットを離れることなく、情報を探して決定できるようにします。フォト ギャラリー、評価、ルート オプションなど、豊富なインライン マップ コンテキストを提供することで、ユーザー エンゲージメントを維持し、実践を促すことができます。
3. インテリジェント コンポーネント
エージェント型 UI ツールキットは、複雑な地理空間ロジックを自動的に処理し、コンテキストとレイアウトをユーザーの意図に即座に適応させます。また、すべてのインタラクションがブランドに関連していると感じられるようにスタイルを設定します。
4. LLM に依存しない
エージェント型 UI ツールキットは、AI スタックに対してモデルに依存しません。Gemini、OpenAI、Anthropic のいずれのモデルを使用している場合でも、またグラウンディングされたデータソースに関係なく、このツールキットは位置情報を可視化するための専用のプレゼンテーション レイヤを提供します。
5. サーバーサイド テンプレートのアーキテクチャ
サーバーサイド テンプレート アーキテクチャでは、サーバーサイドでテンプレートの展開とパラメータの解決を行うことで、コンポーネントのレンダリングを高速化します。これにより、リアルタイムの会話機能のレイテンシが改善されます。
始める
エージェント型 UI ツールキットの使用を開始するには、Google Gemini API キーと Google Maps Platform API キーを使用して初期化する必要があります。
詳細については、スタートガイドをご覧ください。
UI の結果
エージェント型 UI ツールキットには、すぐに使用できる包括的な専用 UI 機能が用意されています。これらのコンポーネントは、ウェブ、Android、iOS で利用できます。
- Place Detail, compact: 特定のスポット（POI）情報をコンパクトなカードに表示
- インライン マップ: ポイントまたはエリアのロケーター
- インライン地図 + ルート: ナビゲーションまたはルートのプレビュー
- インライン地図の詳細: 豊富な画像を使用した場所の詳細またはコンテキスト
システム指示
エージェント型 UI ツールキットは、ホスト LLM に UI をいつどのように構築するかを指示する「システム指示」を提供します。
ガイドライン
ホストモデルは、次のコンセプトを理解する必要があります。
- コンポーネントをユーザー インテントに一致させる方法（方向クエリにインライン マップを使用するなど）。
- 自然言語からスキーマにパラメータをマッピングする方法（ユーザーが「景色の良い」とリクエストした場合に地図モードを航空写真に設定するなど）。
ツール使用スキーマ
エージェント型 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 マップのソースに関する帰属表示の要件
エージェント型 UI ツールキットからの各ツール レスポンスには、ソースが含まれています。ツールキットが提供するツールを使用した結果を表示する場合は、次の要件を満たす方法で、関連する Google マップのソースを含める必要があります。
- Google マップのソースは、ソースがサポートする生成コンテンツの直後に示す必要があります。
- Google マップのソースは、1 回のユーザー操作で表示できる必要があります。
フィードバックを共有
Google マップ エージェント型 UI ツールキットに関するフィードバックを送信するには、次のフォームを使用します。