Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Gemini Enterprise Agent Platform での Google マップによるグラウンディング

このページでは、Gemini Enterprise Agent Platform の Google マップによるグラウンディングが、地理空間コンテキストを提供することで生成 AI アプリケーションの強化にどのように役立つかについて説明します。

概要

Gemini Enterprise Agent Platform の「Google マップによるグラウンディング」は、Gemini モデルと Google マップの地理空間データを接続するサービスです。Google マップは、ビジネス、ランドマーク、スポットなど、何百万もの場所に関する情報にアクセスできます。このデータを使用すると、2 億 5,000 万か所以上の場所に関する情報にアクセスして、モデルのレスポンスのグラウンディングに使用できます。これにより、AI アプリケーションとエージェントはローカルデータと地理空間コンテキストを提供できます。

Google マップ、Google 検索、データソースによるグラウンディングを同時に有効にすることもできます。

Google マップによるグラウンディングの用途

Google マップによるグラウンディングは、次のようなさまざまな用途で使用できます。

「イタリアンエスプレッソを飲める一番近い場所はどこ？」など、近くの場所に関する質問に回答できる会話型アシスタント。
「徒歩圏内にあるファミリー向けのレストランについて詳しく教えて」などの、パーソナライズされた説明やコミュニティのインサイト。
EV 充電スタンドやホテルなど、特定の場所の周辺エリアの要約。

これは、不動産、旅行、モビリティ、ソーシャルメディアアプリのユースケースで役立ちます。

Google マップによるグラウンディングのデモを試す

サポートされているモデル

このセクションでは、Google マップによるグラウンディングをサポートするモデルを示します。

クリックしてサポートされているモデルを開く

Gemini Robotics ER 2 プレビュー
Gemini Nano Banana 2.1
Gemini 4 Argon Cyber Permissive
Gemini 4 Argon
Gemini 3.8 Live
Gemini 3.8 Flash
Gemini 3.7 Flash
Gemini 3.6 Flash
Gemini 3.5 Flash-Lite
Gemini 3.5 Flash
Gemini 3.1 Pro プレビュー
Gemini 3.1 Flash-Lite
Gemini 3.1 Flash Image
Gemini 3 Pro Image
Gemini 3 Flash プレビュー
Gemini 2.5 Pro
Gemini 2.5 Flash-Lite
Gemini Live API ネイティブ音声を使用した Gemini 2.5 Flash
Gemini 2.5 Flash

Gemini モデルの詳細については、Gemini モデルをご覧ください。

Google マップでグラウンディングを使用してモデルのレスポンスをグラウンディングする

このコードサンプルは、Google マップでグラウンディングを使用して、モデルのレスポンスをグラウンディングする方法を示しています。

緯度と経度の座標を使用して、特定の地理的位置に合わせて検索結果をカスタマイズできます。

コンソール

Gemini Enterprise Agent Platform で Google マップによるグラウンディングを使用する手順は次のとおりです。

Google Cloud コンソールで、[Agent Studio] ページに移動します。

Agent Studio に移動
サイドパネルの [モデル設定] で、[グラウンディング] セクションに移動し、[Google 検索、Google マップ] の編集アイコンをクリックします。構成ペインが表示されます。
[Google マップ] の切り替えをオンにします。
[適用] をクリックします。
フィールドにプロンプトを入力し、[送信] をクリックします。プロンプトの回答が Google マップにグラウンディングされます。

Python

インストール

pip install --upgrade google-genai

詳しくは、SDK リファレンスドキュメントをご覧ください。

Vertex AI で Google Gen AI SDK を使用するための環境変数を設定します。

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

from google import genai
from google.genai.types import (
    GenerateContentConfig,
    GoogleMaps,
    HttpOptions,
    Tool,
)

client = genai.Client(http_options=HttpOptions(api_version="v1"))

response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="Where can I get the best espresso near me?",
    config=GenerateContentConfig(
        tools=[
            # Use Google Maps Tool
            Tool(google_maps=GoogleMaps())
        ],
        tool_config=types.ToolConfig(
            retrieval_config = types.RetrievalConfig(
                lat_lng = types.LatLng( # Pass geo coordinates for location-aware grounding
                    latitude=40.7128,
                    longitude=-74.006
                ),
                language_code = "en_US", # Optional: localize Maps results
            ),
        ),
    ),
)

print(response.text)
# Example response:
# 'Here are some of the top-rated places to get espresso near you: ...'

REST

リクエストのデータを使用する前に、次のように置き換えます。

LOCATION: リクエストを処理するリージョン。グローバルエンドポイントを使用するには、エンドポイント名からロケーションを除外し、リソースのロケーションをグローバルに構成します。
PROJECT_ID: 実際のプロジェクト ID。.
MODEL_ID: マルチモーダルモデルのモデル ID。
PROMPT: モデルに送信するプロンプト。
LATITUDE: ロケーションの緯度。たとえば、緯度 37.7749 はサンフランシスコを表します。緯度と経度の座標は、Google マップなどのサービスや他のジオコーディングツールを使用して取得できます。
LONGITUDE: ロケーションの経度。たとえば、経度 -122.4194 はサンフランシスコを表します。
GROUNDING_TYPES: 有効にする Google マップのグラウンディングのタイプ。現在、places と routing をサポートしています。
- places: 施設、有名なスポット、地理的位置などの場所情報を検索します。
- routing: 経路を検索し、経路沿いの場所を検索します。
指定しない場合、デフォルトは places のみです。

HTTP メソッドと URL:

POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent

リクエストの本文（JSON）:

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "PROMPT"
    }]
  }],
  "tools": [{
    "googleMaps": {
      "groundingTypes": {
        "places": {},
        "routing": {}
      }
    }
  }],
  "toolConfig": {
    "retrievalConfig": {
      "latLng": {
        "latitude": LATITUDE,
        "longitude": LONGITUDE
      },
      "languageCode": "en_US"
    }
  },
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent"

PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout. It has a rating of 4.2 stars based on 411 reviews."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "groundingChunks": [
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=9001322937822692826",
              "title": "The Italian Place",
              "placeId": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w"
            }
          },
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=9001322937822692826",
              "title": "Hank's Pasta Bar",
              "placeId": "places/MMVtPzn9FGcevML89",
              "placeAnswerSources": {
                "reviewSnippets": [
                  {
                    "id": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w",
                    "title": "Google Maps Review",
                    "uri": "https://maps.google.com/?cid=9001322937822692826"
                  },
                ]
              }
            }
          },
          ...
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 79,
              "text": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout."
            },
            "groundingChunkIndices": [
              0
            ]
          },
        ],
      }
    }
  ],
  ...
}

場所のプロパティ

このセクションでは、場所の説明に使用され、Google マップのグラウンディングでレスポンスの生成に使用される場所のプロパティについて説明します。これらのプロパティは、Google マップによるグラウンディングで回答できる質問のタイプを特定するために使用されます。

場所のプロパティの例

このリストは、モデルがレスポンスの生成に使用できる場所に関するプロパティのアルファベット順のサンプルです。

住所
混雑状況の傾向
ピックアップ
デビットカード
距離
EV 充電スタンドの情報（コネクタの種類、充電速度、空き状況）
無料駐車場
ガソリン価格と利用可能な燃料の種類
子供におすすめ
生演奏が楽しめるお店
注目のメニュー
営業時間
お支払い方法（現金、クレジットカードなど）
ペット OK
分析情報を確認
ビールを出すお店
ベジタリアン料理の提供
車椅子対応
Wi-Fi

場所のプロパティの使用例

次の例では、さまざまな種類の場所に関する質問で場所のプロパティを使用しています。Google マップでのグラウンディングでは、プロパティを使用してユーザーの意図を理解し、Google マップの場所に関連付けられたデータに基づいて関連性の高い回答を提供します。

家族での夕食を計画する: 次のように質問してみましょう。「イタリアンプレイス」は子供連れでも大丈夫ですか？テイクアウトはできますか？評価はどのくらいですか？
これらの質問への回答は、レストランが家族連れに適しているかどうか、便利なサービスを提供しているかどうかの判断に役立ちます。
メニューのハイライトや看板料理を調べる: 「『The Italian Place』のメニューでおすすめのパスタ料理は何ですか？」ベジタリアン向けのメインディッシュはあるか、マリナラソースについてレビュー担当者は何と言っているか、などです。
これらの質問への回答では、メニューのハイライトとクチコミの分析情報を使用して、特定の料理やコミュニティのお気に入りを探索できます。
友人のアクセシビリティを確認する: 「車椅子対応の入り口があるレストランを探して」と尋ねます。
このプロンプトに対する回答は、特定のアクセシビリティ要件を満たしているかどうかの判断に役立ちます。
夜食を食べられる場所を探す: 次のように尋ねます。「Burger Joint」は今営業していますか？ディナーは提供していますか？金曜日の営業時間は何時から何時までですか？
これらの質問への回答は、特定の時間に特定の食事を提供する営業中の店舗を探す際に役立ちます。
ロードトリップの EV 充電とホテルの設備を計画する: 次のように質問してみましょう。「オーバーナイトモーテル」に宿泊します。敷地内に EV 充電スタンドはあるか、サポートされているコネクタの種類は何か、金曜日の夜に駐車場はどのくらい混雑しているか、などです。
これらの質問への回答は、EV 充電スタンドの情報と混雑状況の傾向を組み合わせたもので、車両の充電を計画したり、滞在中の混雑状況を評価したりするのに役立ちます。
近くのガソリン価格と特殊燃料を比較する: 「カリフォルニア州マウンテンビューの近くでディーゼルまたは水素を販売しているガソリンスタンドはどこですか？現在の価格を比較してください」と尋ねることができます。
これらの質問への回答は、ガソリン価格と利用可能な燃料の種類を活用して、特殊燃料や費用対効果の高い給油場所を特定するのに役立ちます。
クチコミから作業環境を合成する: 次のように尋ねます。「朝食カフェ」のリモートワークにおける騒音レベル、座席の快適さ、Wi-Fi の信頼性について、顧客のクチコミの要約には何と書かれていますか？
このプロンプトに対する回答では、クチコミの分析情報を活用して、コミュニティのコンセンサスに基づいて、カフェが仕事や勉強に適しているかどうかを評価します。

Google マップのグラウンディングされた検索結果の情報は、道路や施設の実際の状況と異なる場合があります。

レスポンスを理解する

Google マップのソースは、groundingChunks 内の groundingMetadata で返されます。場所のソースが返されます。これらのソースは、Google マップのグラウンディングされた結果の生成に役立ちます。uri フィールドは、サポートするクチコミまたは Google マップの場所シートに直接リンクできます。

このコードサンプルは、レスポンス内の場所ソースを示しています。

"groundingChunks": [
  {
    "maps": {
      "uri": "{Link to place sheet or review on Maps}",
      "title": "{Name of Maps Place}",
      "placeId": "{Place ID}"
    }
  }
],

ルーティング - ルート検索

Google マップによるグラウンディングは、経路検索機能をサポートしています。この機能により、AI エージェントは物理的な移動、リアルタイムの移動時間の推定、場所間の空間関係を理解できます。ルート検索機能を使用すると、モデルはパフォーマンスが最適化されたルートと、リアルタイムの状況を考慮した正確な移動時間を提供できます。この統合により、Google マップによるグラウンディングは、移動時間に基づいて場所をフィルタリングし、正確なポイントツーポイントのルートを提供し、特定の移動手段の推定通勤時間を計算できます。

機能

Find Directions は、出発地と目的地の間の正確な移動距離と所要時間を計算します。

「経路を検索」は、以下をサポートしています。

移動手段: 車、徒歩、自転車、公共交通機関、原動機付自転車のルート（すべての国ですべての移動手段が利用できるわけではありません）
複数の経由地: 出発地と目的地の間に最大 13 か所の中間地点を設定できます。
リアルタイム交通情報: 現在の交通状況を考慮して、静的な平均ではなく、正確な「リアルタイム」の移動時間を提供します。

Find Directions でサポートされている質問の種類の例を次に示します。

移動時間に基づく近接性: 「ニューヨークの 1335 6th Ave にあるヒルトンホテルから徒歩 10 分圏内にあるアメリカ料理店は？」
通勤時間の見積もり: 「シアトルのパイクプレイスマーケットからキャピトルヒルまで公共交通機関を利用すると、どのくらい時間がかかりますか？」

[ルート検索] を有効にする

REST API と SDK では、grounding_types が省略されている場合、Google マップによるグラウンディングはデフォルトでプレイスデータのみになります。ルート機能を有効にするには、リクエスト構成の grounding_types で routing を明示的に構成する必要があります。Places ツールと Routing ツールの両方を使用する場合は、grounding_types で places と routing の両方を指定する必要があります。

レスポンスの内容

プロンプトがルート検索機能をトリガーすると、モデルは構造化されたメタデータに裏付けられた自然言語の回答を生成します。これにより、正確な移動情報をユーザーに表示できます。

ペイロードレスポンスで次のデータが返されます。

所要時間: 場所間の移動に必要な時間。リクエストされた場合は交通状況を考慮します。例: 「500 秒」。
距離: ルートの物理的な距離。例: 「1.9 km」。
ポリライン: 地図上に特定のルートパスを視覚的にレンダリングできるエンコードされたテキスト文字列。

プロンプト「宿泊先のヒルトンホテル（ニューヨークの 1335 6th Ave）からカーマインズレストランに行くにはどうすればよいですか？」に対するレスポンスの例を次に示します。

ニューヨークの 1335 6th Ave にあるヒルトンホテルから Carmine's レストランに行くには、Carmine's - Time Square（200 W 44th St, New York, NY 10036, USA）に向かいます。

徒歩経路は次のとおりです。

ヒルトンホテルから出発: 1335 6th Ave. にあるヒルトンホテルを出ます。

6th Avenue を南に進む: 6th Avenue（Avenue of the Americas）を W 44th Street に向かって南に進みます。

W 44th Street に右折: W 44th Street に右折します。

Carmine's は左側にあります。W 44th Street を進むと、左側の 200 W 44th St に Carmine's があります。

この徒歩ルートは約 0.8 km で、所要時間は 10 ～ 15 分ほどです。

プロンプト「シアトルのパイクプレイスマーケットからキャピトルヒルまで公共交通機関で移動する場合、どのくらい時間がかかりますか？」に対するレスポンスの例を次に示します。

シアトルのパイクプレイスマーケットからキャピトルヒルまで公共交通機関を利用して移動するには、いくつかの方法があります。

トラム（路面電車）: パイクプレイスマーケット近くのウェストレイクからキャピトルヒルまで、トラムで約 3 分です。乗り換えを含めると、移動時間は合計で約 9 分です。トラムは 10 分おきに出発します。

バス: パイクストリートと 4 番街（パイクプレイスマーケットの近く）からキャピトルヒル行きのキング郡メトロバスが 20 分おきに運行しており、所要時間は約 11 分です。または、49 系統のバスで約 16 分です。

ルーティング - ルート沿いの検索

ルート沿い検索を使用すると、AI エージェントは、ユーザーの予定しているルートに地理的に関連し、便利なスポットを検出できます。Google マップのルート検索エンジンと空間検索エンジンで回答をグラウンディングすることで、モデルは、遠回りを最小限に抑えるおすすめを提供し、ロードトリップや通勤のロジスティクスフローを理解できます。

機能

ルート沿い検索を使用すると、出発地と目的地の間に生成されたルート沿いにある特定のビジネス、設備、観光スポットを特定できます。サポートされている移動モードは「ドライブ」のみです。

次の例は、ルート沿い検索ツールで処理できる質問のタイプを示しています。

基本的なルート検索: 「1800 Amphibious Blvd. Mountain View, CA 94045 から 456 Sunny St, Sunnyvale CA までのルート沿いにあるガソリンスタンドを検索して。」（通常、出発地と目的地の住所はチャット履歴から取得されます）。
場所のプロパティに基づく検索: 「サンフランシスコと 1800 Amphibious Blvd. Mountain View, CA 94045 の間に、4 つ星以上の評価のベーカリーはありますか？」
複数区間のルート検索: 「サンフランシスコからサンルイスオビスポ、ロサンゼルスへのドライブ旅行を計画しています。サンフランシスコとサンルイスオビスポの間、そしてサンルイスオビスポとロサンゼルスの間で、EV 充電器のオプションを 3 つずつ提案してください。」

ルート沿いの検索を有効にする

経路沿いの検索では、Places と Routing の両方の機能を使用して、移動経路沿いの場所を検索します。REST API と SDK では、リクエスト構成の grounding_types で places と routing の両方を明示的に構成する必要があります。

レスポンスの内容

プロンプトが Search Along Route ツールをトリガーすると、モデルは、Places データと Routing データの両方を組み合わせた構造化メタデータに裏付けられた自然言語の回答を生成します。これにより、提案された場所が実際の移動経路にとって本当に便利であることを確認できます。groundingMetadata には、返された場所の groundingChunks と、検索されたルートが含まれます。

プロンプトの例 [基本的なルート検索]:

1800 Amphibious Blvd. Mountain View, CA 94045 から 456 Sunny St, Sunnyvale CA までのルート上にあるガソリンスタンドを検索します。

レスポンスの例 [基本的なルート検索]:

1800 Amphibious Blvd. Mountain View, CA 94045 から 456 Sunny St, Sunnyvale, CA へのルート沿いにあるガソリンスタンドをいくつかご紹介します。

Example Gas station - 123 Example Rd, Sunnyvale, CA 94045 にあります。 122 件のクチコミで 3.5 の評価を得ており、水素、プロパン、ガソリンの販売と洗車サービスを提供しています。今夜は午後 9 時 50 分まで営業しており、トイレがあります。

Fictional Gas station - 456 Fictional Ave, Sunnyvale, CA 94045 にあります。52 件のクチコミによって 3.6 という評価を受けており、コンビニエンスストアと洗車場を併設しています。このガソリンスタンドは 24 時間営業で、トイレがあります。

Generic Gas station - 789 W Generic St, Sunnyvale, CA 94045 にあります。35 件のクチコミによって 3.6 という評価を受けています。このステーションは 24 時間営業で、トイレがあります。

プロンプトの例 [複数区間のルート検索]:

サンフランシスコからサンルイスオビスポ、ロサンゼルスへのドライブ旅行を計画しています。サンフランシスコとサンルイスオビスポの間、およびサンルイスオビスポとロサンゼルスの間で、EV 充電器のオプションを 3 つずつ提案してください。

回答例 [複数区間のルート検索]:

サンフランシスコからロサンゼルスへのロードトリップで、サンルイスオビスポに立ち寄る場合の EV 充電器のオプションをいくつか紹介します。

サンフランシスコとサンルイスオビスポの間:

Example Charger: 123 Example Blvd, Campbell, CA 95008 にあるこのステーションの評価は 4.5 です。

Fictional EV Station: 456 Fictional Rd, Gilroy, CA 95008 にある充電スタンドで、評価は 4.4 です。

Generic Charging Station: この充電スタンドは 789 Generic St, Salinas, CA 95008 にあり、評価は 3.5 です。

サンルイスオビスポとロサンゼルスの間:

Example Charger: 123 Example Rd, San Luis Obispo, CA 93123 にあるこのステーションの評価は 4.3 です。

Fictional EV Station: このステーションは 456 Fictional Ave, Santa Barbara, CA 93123 にあり、評価は 3.9 です。

Generic Charging Station: 789 Generic St, Glendale, CA 93123 にあり、評価は 3.0 です。

それでは、よいドライブを！

サービスの使用要件

このセクションでは、Google マップによるグラウンディングのサービス使用要件について説明します。

Google マップのソースの使用についてユーザーに通知する

Google マップのグラウンディングされた結果ごとに、各レスポンスをサポートするソースが groundingChunks で提供されます。次のメタデータも返されます。

ソースの URI
タイトル
ID

Gemini Enterprise Agent Platform の「Google マップによるグラウンディング」の結果を表示する場合は、関連する Google マップのソースを指定し、ユーザーに次の情報を通知する必要があります。

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

音声ファーストのインターフェースの場合

ソースの表示: Google マップのソースは、AI 音声会話の逐語的な履歴記録を表示するコンパニオン UI に表示する必要があります。このレコードは、ソーシング要件に準拠する必要があり、該当するデータキャッシュとストレージの上限が適用されます。

ソースの積極的な開示: エンドユーザーは、操作時に Google マップが果たす役割と、詳細なソースの確認方法を合理的に認識できる必要があります。

ソースの積極的な開示では、次の点を伝える必要があります。

AI 生成コンテンツには、Google マップの情報が含まれている場合があります。
詳細なソースはコンパニオン UI で確認できます。

ソースの積極的な開示は、次のいずれかの方法で行う必要があります。

視覚的な表示: 画面付きのデバイスで音声操作が行われる場合は、Google マップによるグラウンディングが使用されるたびに、アクティブな開示を画面に表示します。
音声による通知: 有効な開示事項をお客様に読み上げます。これは、Google マップによるグラウンディングでサポートされる最初のインタラクション中に行われ、少なくとも 6 か月ごとに繰り返される必要があります。

開示の例: 「AI 生成コンテンツには、Google マップの情報が含まれている場合があります。詳細なソースはコンパニオンアプリで確認できます。」

永続的な開示: Google マップのコンテンツが AI 生成コンテンツで使用される可能性があるという説明は、エンドユーザーが常にアクセスできるようにする必要があります（音声設定メニューや音声操作の開示など）。

ユーザーからの問い合わせ: 音声アシスタントは、AI 生成コンテンツに Google マップの情報が含まれている場合など、コンテンツのソースに関するエンドユーザーからの問い合わせに正確に回答する必要があります。Google マップがソースの場合は、特定のソース情報にアクセスするために、コンパニオン UI にエンドユーザーを誘導します。

Google マップへのリンクを含む Google マップのソースを表示する

groundingChunks の各ソースについて、次の要件に沿ってリンクのプレビューを生成する必要があります。

Google マップのテキスト帰属表示のガイドラインに従って、各ソースを Google マップに帰属させます。
レスポンスで提供されたソースのタイトルを表示します。
レスポンスの uri を使用してソースにリンクします。

これらの画像は、ソースと Google マップのリンクを表示するための最小要件を示しています。

ソースが表示された回答を含むプロンプト

ソースのビューは折りたたむことができます。

プロンプトと回答、ソースが折りたたまれた状態

省略可: リンクのプレビューを次のような追加コンテンツで強化します。

Google マップのテキスト帰属表示の前に Google マップのファビコンが挿入されます。
ソース URL（og:image）の写真。

Google マップのデータプロバイダとそのライセンス条項について詳しくは、Google マップと Google Earth の法的通知をご覧ください。

Google マップのテキストでの帰属表示に関するガイドライン

テキストでソースを Google マップに帰属させる場合は、次のガイドラインに従ってください。

「Google Maps」というテキストは一切変更しないでください。
- Google Maps の文字の大小は変更しないでください。
- Google Maps を複数行に折り返さないでください。
- Google Maps を他の言語にローカライズしないでください。
- HTML 属性 translate="no" を使用して、ブラウザが Google Maps を翻訳しないようにします。
次の表の説明に従って、Google Maps のテキストのスタイルを設定します。

プロパティ	スタイル
フォントファミリー	Roboto。フォントの読み込みは任意です。
代替フォントファミリー	プロダクトですでに使用されている Sans Serif の本文フォント、またはデフォルトのシステムフォントを呼び出すための Sans-Serif
フォントスタイル	標準
フォントの太さ	400
フォントの色	白、黒（#1F1F1F）、グレー（#5E5E5E）。背景に対してアクセシビリティの高い（4.5:1）コントラストを維持します。
フォントサイズ	最小フォントサイズ: 12sp 最大フォントサイズ: 16sp sp について詳しくは、マテリアルデザインのウェブサイトでフォントサイズの単位をご覧ください。
文字間隔	標準

CSS の例

次の CSS は、白または明るい背景に適切なタイポグラフィスタイルと色で Google Maps をレンダリングします。

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

プレイス ID とレビュー ID

Google マップのデータには、プレイス ID とレビュー ID が含まれます。次のレスポンスデータをキャッシュに保存してエクスポートできます。

placeId
reviewId

Google マップによるグラウンディングの利用規約に定められているキャッシュ保存の制限は適用されません。

禁止地域

Google マップでのグラウンディングには、安全で信頼性の高いプラットフォームを維持するため、特定のコンテンツとアクティビティに対する制限があります。ユーザーは、禁止されている地域で Google マップによるグラウンディングを提供する顧客アプリケーションを配布または販売できません。詳しくは、Google Maps Platform で禁止されている地域をご覧ください。禁止地域のリストは随時更新される可能性があります。

課金

Google マップによるグラウンディングでは、Google マップのクエリごとに料金が発生します（料金をご覧ください）。

お客様が Gemini に送信したリクエストにより、Google マップへの 1 つ以上のクエリが生成されることがあります。次の表に例をいくつか示します。

サンプルプロンプト	Google マップの推定クエリ数	クエリ生成の例
ヒルトンホテル（ニューヨーク市 1335 6th Ave）の近くの寿司レストラン。	3 件の Place Search クエリ（Google マップクエリ）。このプロンプトで 3 件のファンアウトクエリが生成されると想定しています。	3 つのファンアウト Place Search クエリ: - ヒルトンミッドタウンマンハッタン周辺の最高の寿司 - 1335 6th Ave New York 周辺の寿司レストラン - 1335 6th Ave New York 周辺の日本料理レストラン
ヒルトンホテル（1335 6th Ave）から 200 W 44th St, New York への行き方を教えて。	1 経路検索クエリ（Google マップのクエリ）	1 経路検索クエリ: - Hilton Hotel, 1335 6th Ave, New York, NY から 200 W 44th St, New York, NY 10036 への経路
ヒルトンホテル（ニューヨーク市 1335 6th Ave）から空港までの距離。	Google マップクエリ 4 件（Place Search クエリ 1 件 + ルート検索クエリ 3 件）。Place Search で 3 つの空港が返されると想定。	1 件のファンアウト Place Search 検索クエリ: - ニューヨーク市近郊の空港 3 件の Find Directions クエリ: - 1335 6th Ave, New York, NY 10019, USA から John F. Kennedy International Airport, Queens, NY 11430, USA - Directions from 1335 6th Ave, New York, NY 10019, USA to Newark Liberty International Airport, Newark, NJ 07114, USA - Directions from 1335 6th Ave, New York, NY 10019, USA to LaGuardia
1800 Amphibious Blvd. Mountain View, CA 94045 から 456 Sunny St, Sunnyvale CA までのルート沿いにあるガソリンスタンドを検索します。	1 回のルート沿い検索クエリ（Google マップのクエリ）	1 件のルート沿い検索クエリ: - 1800 Amphibious Blvd. Mountain View, CA 94045 から 456 Sunny St, Sunnyvale CA までのガソリンスタンド

次のステップ

Gemini モデルを独自のデータでグラウンディングする方法の詳細については、独自のデータでグラウンディングするをご覧ください。
責任ある AI のベストプラクティスと Gemini Enterprise Agent Platform の安全フィルタについては、責任ある AI をご覧ください。

Gemini Enterprise Agent Platform での Google マップによるグラウンディング コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

概要

Google マップによるグラウンディングの用途

サポートされているモデル

クリックしてサポートされているモデルを開く

Google マップでグラウンディングを使用してモデルのレスポンスをグラウンディングする

コンソール

Python

インストール

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

場所のプロパティ

場所のプロパティの例

場所のプロパティの使用例

レスポンスを理解する

ルーティング - ルート検索

機能

[ルート検索] を有効にする

レスポンスの内容

ルーティング - ルート沿いの検索

機能

ルート沿いの検索を有効にする

レスポンスの内容

サービスの使用要件

Google マップのソースの使用についてユーザーに通知する

音声ファーストのインターフェースの場合

Google マップへのリンクを含む Google マップのソースを表示する

Google マップのテキストでの帰属表示に関するガイドライン

CSS の例

プレイス ID とレビュー ID

禁止地域

課金

次のステップ

Gemini Enterprise Agent Platform での Google マップによるグラウンディング