Grounding Lite

Google Maps Platform Grounding Lite は、Model Context Protocol（MCP）をサポートするサービスです。このサービスを使用すると、Google マップの信頼できる地理空間データを使用して AI アプリケーションを簡単にグラウンディングできます。MCP サーバーは、LLM が場所、天気、ルートの機能にアクセスできるようにするツールを提供します。Grounding Lite は、MCP サーバーをサポートするツールで有効にすることで試すことができます。

ツール

Grounding Lite には、LLM が次の Google マップの機能にアクセスできるツールが用意されています。

  • 場所を検索する: 場所に関する情報をリクエストし、AI によって生成された場所データの概要、プレイス ID、緯度と経度の座標、概要に含まれる各場所の Google マップのリンクを取得します。返されたプレイス ID と緯度 / 経度座標を他の Google Maps Platform API と組み合わせて使用すると、地図上に場所を表示できます。
  • 天気を調べる: 天気に関する情報をリクエストし、現在の状況、1 時間ごとの天気予報、毎日の天気予報を返します。

  • ルートを計算する: 2 つの地点間の運転ルートまたは徒歩ルートに関する情報をリクエストし、ルートの距離と所要時間の情報を返します。

Maps Grounding Lite MCP サーバーを有効にすると、LLM はサーバーによって公開された新しいツールを呼び出して、上記のデータ型の追加のグラウンディング情報を返すことができます。LLM はこの追加情報をコンテキストに使用できますが、LLM が最終的に生成するレスポンスには、MCP サーバーから返された情報が正確に含まれていない可能性があります。生成された回答の正確性を確認する必要があります。

課金と割り当て

Grounding Lite は試験運用期間中は無料で使用できます。ただし、Grounding Lite が提供するツールには次の割り当てが適用されます。

  • 場所の検索: プロジェクトごとに 1 分あたり 100 件のクエリ。プロジェクトごとに 1 日あたり 1,000 件のクエリ。
  • 天気を調べる: プロジェクトごとに 1 分あたり 300 件のクエリ。
  • コンピューティング ルート: プロジェクトごとに 1 分あたり 300 件のクエリ。

ポリシーと利用規約

Grounding Lite には、このサービスのサービス固有の規約を含む Google Maps Platform 利用規約が適用されます。このセクションでは、互換性のある LLM やソース アトリビューションの要件など、Grounding Lite の追加のサービス使用要件について説明します。

互換性のある LLM の要件

Grounding Lite は、Google Maps Platform 利用規約に準拠した LLM でのみ使用できます。

たとえば、Google マップ コンテンツが、お客様が使用する LLM によってキャッシュに保存されたり、保存されたり、改善に使用されたりしないようにする責任はお客様にあります。Grounding Lite を使用する前に、Grounding Lite で使用するモデルの利用規約を確認する必要があります。モデルに入力されたデータをモデルのトレーニングや改善に使用するモデルでは、Grounding Lite を使用しないでください。お客様は、モデルの使用が Google Maps Platform 利用規約（サービス固有の規約を含む）の Google マップ コンテンツに関する制限に完全に準拠していることを確認する責任を負います。

Google マップのソースの帰属表示の要件

Grounding Lite からの各ツール レスポンスには、ソースが含まれます。Grounding Lite が提供するツールを使用して結果を表示する場合は、次の要件を満たす方法で、関連する Google マップのソースを含める必要があります。

  • Google マップのソースは、ソースがサポートする生成コンテンツの直後に記載する必要があります。この生成コンテンツは、グラウンディングされた出力とも呼ばれます。
  • Google マップのソースは、1 回のユーザー操作で表示できる必要があります。

場所検索ツールの情報源

search_places ツールの places フィールドには、summary をサポートするソースが用意されています。places の場合、次のメタデータが返されます。

  • place（リソース名）
  • id
  • location
  • googleMapsLinks

場所ごとに、次の要件を満たすリンク プレビューを生成する必要があります。

  • Grounding Lite のテキスト帰属表示のガイドラインに沿って、各ソースを Google マップに帰属表示します。
  • レスポンスで提供された googleMapsLinks から、Open Graph メタデータ og:title のソースページのタイトルを表示します。
  • レスポンスの places.googleMapsLinks.placeUrl を使用してソースにリンクします。

MCP サーバーを使用するように LLM を構成する

Grounding Lite を使用するには、まず Maps Grounding Lite API サービスが有効になっている API キーが必要です。次に、MCP サーバーにアクセスするように LLM を構成できます。Grounding Lite MCP サーバーは Streamable HTTP トランスポートを使用します。

API キーを作成または構成する

既存の API キーを Maps Grounding Lite で使用することも、新しい API キーを作成することもできます。ただし、キーで Maps Grounding Lite API サービスを有効にする必要があります。Maps Grounding Lite API は試験運用中は課金されませんが、プロジェクトで課金を有効にする必要があります。

API を有効にするには:

  1. Google Cloud コンソールで、Grounding Lite に使用するプロジェクトを選択します。
  2. Google Cloud コンソールでプロジェクトの課金を有効にします。
  3. 上部のナビゲーションから、Cloud Shell ターミナルを開きます。

  4. 次のコマンドを実行して、サービスと MCP エンドポイントを有効にします。

    gcloud beta services enable mapstools.googleapis.com --project=PROJECT_ID
gcloud beta services mcp enable mapstools.googleapis.com --project=PROJECT_ID

  5. Google Maps Platform のスタートガイドの手順に沿って、API キーを作成または構成します。

API キーは、ヘッダー X-Goog-Api-Key を使用して MCP サーバーに渡す必要があります。これは、LLM の MCP ツール構成でカスタム HTTP ヘッダーとして指定する必要があります。

Grounding Lite MCP サーバーにアクセスするように LLM を構成する

Maps Grounding Lite API サービスが有効になっている API キーを取得したら、対応する MCP 構成ドキュメントに沿って、Grounding Lite MCP サーバーの URL（https://mapstools.googleapis.com/mcp）を使用して MCP サーバーにアクセスするように LLM を構成できます。

Gemini CLI を使用して Grounding Lite を構成する

このセクションでは、Gemini CLI を使用して Grounding Lite MCP サーバーを構成する方法の例を示します。詳細については、Gemini CLI を使用した MCP サーバーをご覧ください。

  1. Gemini CLI をインストールしたら、add コマンドを使用して Maps Grounding Lite MCP サーバーを構成できます。

    gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp

    構成が成功すると、サーバーがユーザー設定に追加されたことを確認するメッセージが表示されます。

  2. サーバーが正しく機能していることを確認するには、/mcp list コマンドを実行します。

    > /mcp list

Configured MCP servers:

maps-grounding-lite-mcp - Ready (3 tools)
Tools:
-   compute_routes
-   lookup_weather
-   search_places

  3. CLI を使用して、マップ関連の質問を始めます。たとえば、「マウンテン ビューのおすすめのレストランを教えて」と入力すると、ユーザーに代わって search_places ツールが呼び出されます。

フィードバックの共有

Grounding Lite に関するフィードバックを送信するには、次のフォームを使用します。