Vertex AI 的「利用 Google 地圖建立基準」

Vertex AI 的「利用 Google 地圖建立基準」結合了 Gemini 的強大功能和 Google 地圖，可存取超過 2.5 億個地點的資訊。這項透過 Vertex AI 提供的重大整合功能，可協助您打造新一代生成式應用程式。

本頁說明如何使用 Google 地圖，為 LLM 回覆提供基礎資訊。

總覽

Vertex AI 中的 Google 地圖基礎服務可讓您搭配使用 Google 地圖資料與 LLM，針對提示提供更準確且符合情境的回覆。Google 地圖基準已與 Vertex AI 整合，可支援您搭配 Gemini 模型使用地理資料。

透過 Google 地圖的基礎功能，你可以發掘新地點、規劃活動，以及取得各種地點的建議。您可以執行以下操作：

  • 向對話式助理詢問該區域和附近的任何地點。Google 助理可以存取交通時間資訊，並告知某個地點與你所在位置的距離。例如「附近有公園嗎？」
  • 查看符合條件的個人化地點說明。例如：可以進一步說明附近的公園，以及步行可達的家庭友善餐廳嗎？

透過 Google 地圖基礎功能，您可以從 LLM 支援的對話建立生成式 AI 應用程式，並使用地理空間脈絡生成個人化的位置資訊摘要，協助您做出更明智的決策。

如需協助，請傳送訊息給 maps-grounding-feedback-external@google.com。

支援的模型

本節列出支援 Google 地圖基礎模型的模型。

如要進一步瞭解 Gemini 模型，請參閱「Gemini 模型」。

存取「利用 Google 地圖建立基準」功能

如要在 Vertex AI 中使用「利用 Google 地圖建立基準」，請按照下列步驟操作：

  1. 如要申請在特定專案中使用 Vertex AI 的「利用 Google 地圖建立基準」功能，請填寫並提交選擇加入或退出 Google 地圖表單。

    您必須填寫這份表單，提供電子郵件地址、公司名稱、專案 ID，並接受相關條款。

  2. 如果您沒有專案，請參閱「建立及管理專案」。

  3. 在 Google Cloud 控制台中，前往「Maps Grounding API」頁面。

    前往 Maps Grounding API

    如要啟用 Maps Grounding API，請按一下「啟用」。選取專案，系統會顯示 Maps Grounding API 頁面。

  4. 在 Google Cloud 控制台中，前往「Maps JavaScript API」頁面。

    前往 Maps JavaScript API

    如要啟用 JavaScript，請按一下「啟用」。選取專案，系統會顯示「APIs & Services」(API 和服務) 頁面。

  5. 如要確認 Google 地圖是否已啟用，請前往 Vertex AI Studio。

    前往 Vertex AI Studio

    1. 選取您已啟用 API 的專案。

    2. 如要在模型窗格的「工具」部分開啟 Google 地圖功能，請按一下「基礎：Google」切換按鈕。

    3. 選取「Google 地圖預覽版」。

    4. 輸入 API 金鑰。

      1. 如果沒有 API 金鑰，請參閱「建立 API 金鑰」。
      2. 限制 API 金鑰，以限制 API 的使用。

    5. 選取「位置」，即可取得以地點為基礎的回覆。

    6. 按一下 [套用]。

地點屬性

本節列出用於描述地點的地點屬性，以及 Grounding with Google Maps 用於生成回覆的屬性。這些屬性是用來判斷 Grounding with Google Maps 可回答的問題類型。

地點屬性範例

這份清單提供地點屬性的範例，並依字母順序排列，模型可能會使用這些屬性生成回覆。

  • 地址
  • 只收現金
  • 信用卡
  • 店外取貨
  • 簽帳金融卡
  • 距離
  • 免費停車場
  • 提供現場音樂演奏
  • 兒童菜單
  • 營業時間
  • 寵物友善
  • 供應啤酒
  • 供應素食料理
  • 有無障礙設施
  • Wifi

使用地點屬性的範例

以下範例在有關不同類型地點的問題中，使用地點屬性。以 Google 地圖為基礎可使用這些屬性瞭解您的意圖，然後根據 Google 地圖中與地點相關聯的資料提供相關答案。

  • 規劃家庭聚餐：你可以詢問「The Italian Place」是否適合兒童，以及是否提供外帶服務。他們的評分是多少？

    這些問題的答案有助於判斷餐廳是否適合家庭用餐，以及是否提供便利的服務。

  • 為朋友確認無障礙設施：你可能會詢問「我需要有無障礙入口的餐廳」。

    這項提示的回覆內容可協助你判斷該地點是否符合特定無障礙需求。

  • 尋找宵夜地點：你可以問「『Burger Joint』現在營業嗎？他們提供晚餐嗎？星期五的營業時間是什麼時候？

    回答這些問題有助於您在特定時間找到供應特定餐點的營業場所。

  • 與客戶在咖啡廳會面：你可能會問「『中央咖啡廳』有 Wi-Fi 嗎？」他們是否供應咖啡？價位如何？是否接受信用卡？

    根據這些問題的答案，您可以評估咖啡廳是否適合舉辦商務會議，例如設施、供應項目和付款方式。

使用 Grounding with Google Maps 建立模型基準

您可以使用 Google Maps API，讓模型的回覆內容以 Google 地圖為依據。

這些程式碼範例說明如何使用 Maps API，透過 Grounding with Google Maps 奠定模型回覆的基礎。

Python

安裝

pip install --upgrade google-genai

詳情請參閱 SDK 參考說明文件。

設定環境變數，透過 Vertex AI 使用 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_VERTEXAI=True
 

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

# TODO(developer): Update below line with your Google Maps API key
GOOGLE_MAPS_API_KEY = "YOUR_GOOGLE_MAPS_API_KEY"

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

response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="Recommend a good restaurant in San Francisco.",
    config=GenerateContentConfig(
        tools=[
            # Use Google Maps Tool
            Tool(
                google_maps=GoogleMaps(
                    auth_config=AuthConfig(
                        api_key_config=ApiKeyConfig(
                            api_key_string=GOOGLE_MAPS_API_KEY,
                        )
                    )
                )
            )
        ],
    ),
)

print(response.text)
# Example response:
# 'San Francisco boasts a vibrant culinary scene...'

REST

使用任何要求資料之前，請先替換以下項目：

  • LOCATION：處理要求的區域。
  • PROJECT_ID：您的專案 ID。
  • MODEL_ID：多模態模型的模型 ID。
  • TEXT： 提示中要加入的文字指令。
  • API_KEY：您的 API 金鑰。
  • LATITUDE：地點的緯度。
  • LONGITUDE：地點的經度。

HTTP 方法和網址：

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

JSON 要求主體：

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "TEXT"
    }]
  }],
  "tools": [{
    "googleMaps": {
      "authConfig": {
        "apiKeyConfig": {
          "apiKeyString": "API_KEY"
        }
      }
    }
  }],
  "toolConfig": {
    "retrievalConfig": {
      "latLng": {
        "latitude": LATITUDE,
        "longitude": LONGITUDE
      }
    }
  },
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

如要傳送要求，請展開以下其中一個選項：

您應該會收到如下的 JSON 回應：

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Here are a few options for late-night burgers in San Jose, based on the search results. Keep in mind that \"late night\" can be subjective, so I've included places with varying closing times. I recommend double-checking their hours before you go, as these can change.\n\n*   **Campus Burgers:** Open until 12:00 AM every night except Sunday (closed).\n*   **Lazy Dog Restaurant & Bar:** Open until 12:00 AM every night.\n*   **Dough Burger:** Open until 1:30 AM Monday through Thursday and Sunday, and until 3:00 AM on Friday and Saturday.\n*   **El Apartamento Colombian Burgers:** Open until 1:00 AM on Friday and Saturday, and until 10:30 PM Monday through Wednesday and until 11:00 PM Thursday and Sunday.\n*   **Paper Plane:** Open until 2:00 AM Thursday through Saturday, and until 12:00 AM on Tuesday and Wednesday and Sunday. Closed on Monday.\n\nNote that opening hours are subject to change.\n"
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "retrievalQueries": [
          "late night burger san jose"
        ],
        "groundingChunks": [
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=15700677770979677665",
              "title": "El Apartamento Colombian Burgers",
              "text": "**About:**\n\n* **Type:** Hamburger Restaurant\n* **Address:** 76 E Santa Clara St, San Jose, CA 95113, USA\n* **Open Now:** No\n* **Rating:** 4.9 (25 reviews)\n* **Offers Takeout:** Yes\n* **Offers Delivery:** Yes\n* **Offers Dine-in:** Yes\n* **Good for Children:** Yes\n* **Outdoor Seating:** No\n* **Live Music:** No\n* **Curbside Pickup:** Yes\n\n**Opening Hours (local time):**\n\n* Monday: 5:00 – 10:30 PM\n* Tuesday: 5:00 – 10:30 PM\n* Wednesday: 5:00 – 10:30 PM\n* Thursday: 4:00 – 11:00 PM\n* Friday: 4:00 PM – 1:00 AM\n* Saturday: 4:00 PM – 1:00 AM\n* Sunday: 4:00 – 11:00 PM\n\n**Parking options:**\n\n* **Free street parking:** Yes\n\n**Accessibility:**\n\n* **Wheelchair accessible parking:** Yes\n* **Wheelchair accessible entrance:** Yes\n\n**Payment options:**\n\n* **Credit Card:** Yes\n* **Cash Only:** No\n\n**Distance & Travel Time:**\n\n* 4733.0 kilometers\n* 43.4 hours"
            }
          },
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=8798666889278262772",
              "title": "Campus Burgers",
              "text": "**About:**\n\n* **Type:** Hamburger Restaurant\n* **Address:** 108 Paseo de San Antonio, San Jose, CA 95113, USA\n* **Open Now:** Yes\n* **Rating:** 4.4 (207 reviews)\n* **Price Level:** Inexpensive\n* **Phone:** (408) 352-5507\n* **Additional Summary:** Simple hamburger restaurant with a limited menu of comfort fare such as burgers and fries.\n* **Offers Takeout:** Yes\n* **Offers Delivery:** Yes\n* **Offers Dine-in:** Yes\n* **Good for Children:** Yes\n* **Good for Groups:** Yes\n* **Outdoor Seating:** Yes\n* **Live Music:** No\n* **Menu for Children:** No\n* **Serves Cocktails:** No\n* **Serves Dessert:** Yes\n* **Serves Coffee:** No\n* **Good for Watching Sports:** No\n* **Serves Lunch:** Yes\n* **Serves Dinner:** Yes\n\n**Opening Hours (local time):**\n\n* Monday: 11:00 AM – 12:00 AM\n* Tuesday: 11:00 AM – 12:00 AM\n* Wednesday: 11:00 AM – 12:00 AM\n* Thursday: 11:00 AM – 12:00 AM\n* Friday: 11:00 AM – 12:00 AM\n* Saturday: 11:00 AM – 12:00 AM\n* Sunday: Closed\n\n**Parking options:**\n\n* **Paid parking lot:** Yes\n* **Free street parking:** Yes\n* **Paid street parking:** Yes\n* **Valet parking:** No\n* **Paid garage parking:** Yes\n\n**Accessibility:**\n\n* **Wheelchair accessible parking:** Yes\n* **Wheelchair accessible entrance:** Yes\n\n**Payment options:**\n\n* **Credit Card:** Yes\n* **Debit Card:** Yes\n* **Cash Only:** No\n* **NFC:** Yes\n\n**Distance & Travel Time:**\n\n* 4732.5 kilometers\n* 43.4 hours"
            }
          },
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=3915125089239094417",
              "title": "Paper Plane",
              "text": "**About:**\n\n* **Type:** Bar\n* **Address:** 72 S 1st St, San Jose, CA 95113, USA\n* **Open Now:** No\n* **Rating:** 4.4 (2452 reviews)\n* **Price Level:** Moderate\n* **Phone:** (408) 713-2625\n* **Summary:** Relaxed spot with a long bar in an exposed brick space for creative or classic cocktails & snacks.\n* **Additional Summary:** Casual, popular bar serving signature cocktails and New American fare, including burgers and tacos.\n* **Takes Reservations:** Yes\n* **Offers Takeout:** Yes\n* **Offers Dine-in:** Yes\n* **Good for Children:** No\n* **Allows Dogs:** No\n* **Has Restroom:** Yes\n* **Good for Groups:** Yes\n* **Outdoor Seating:** No\n* **Live Music:** No\n* **Serves Cocktails:** Yes\n* **Good for Watching Sports:** No\n* **Serves Beer:** Yes\n* **Serves Wine:** Yes\n\n**Opening Hours (local time):**\n\n* Monday: Closed\n* Tuesday: 5:00 PM – 12:00 AM\n* Wednesday: 5:00 PM – 12:00 AM\n* Thursday: 5:00 PM – 2:00 AM\n* Friday: 5:00 PM – 2:00 AM\n* Saturday: 5:00 PM – 2:00 AM\n* Sunday: 5:00 PM – 12:00 AM\n\n**Parking options:**\n\n* **Paid parking lot:** Yes\n* **Free street parking:** Yes\n* **Paid street parking:** Yes\n* **Valet parking:** No\n* **Paid garage parking:** Yes\n\n**Accessibility:**\n\n* **Wheelchair accessible entrance:** Yes\n* **Wheelchair accessible restroom:** Yes\n* **Wheelchair accessible seating:** Yes\n\n**Payment options:**\n\n* **Credit Card:** Yes\n* **Cash Only:** No\n* **NFC:** Yes\n\n**Distance & Travel Time:**\n\n* 4733.0 kilometers\n* 43.4 hours"
            }
          },
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=12662287798905863411",
              "title": "Lazy Dog Restaurant & Bar",
              "text": "**About:**\n\n* **Type:** American Restaurant\n* **Address:** 5305 Almaden Expy, San Jose, CA 95118, USA\n* **Open Now:** Yes\n* **Rating:** 4.2 (940 reviews)\n* **Price Level:** Moderate\n* **Phone:** (408) 786-9594\n* **Summary:** Relaxed, lodge-chic chain serving global comfort fare, including stir-fries, pot roast & pastas.\n* **Additional Summary:** American food including comfort fare and small plates served in a casual setting with a bar.\n* **Takes Reservations:** Yes\n* **Offers Takeout:** Yes\n* **Offers Delivery:** Yes\n* **Offers Dine-in:** Yes\n* **Good for Children:** Yes\n* **Allows Dogs:** Yes\n* **Has Restroom:** Yes\n* **Good for Groups:** Yes\n* **Outdoor Seating:** Yes\n* **Live Music:** No\n* **Menu for Children:** Yes\n* **Serves Cocktails:** Yes\n* **Serves Dessert:** Yes\n* **Serves Coffee:** Yes\n* **Has Wifi:** Yes\n* **Good for Watching Sports:** Yes\n* **Curbside Pickup:** Yes\n* **Serves Lunch:** Yes\n* **Serves Dinner:** Yes\n* **Serves Beer:** Yes\n* **Serves Wine:** Yes\n* **Serves Brunch:** Yes\n\n**Opening Hours (local time):**\n\n* Monday: 11:00 AM – 12:00 AM\n* Tuesday: 11:00 AM – 12:00 AM\n* Wednesday: 11:00 AM – 12:00 AM\n* Thursday: 11:00 AM – 12:00 AM\n* Friday: 11:00 AM – 12:00 AM\n* Saturday: 10:00 AM – 12:00 AM\n* Sunday: 10:00 AM – 12:00 AM\n\n**Parking options:**\n\n* **Free parking lot:** Yes\n* **Free street parking:** Yes\n* **Valet parking:** No\n\n**Accessibility:**\n\n* **Wheelchair accessible parking:** Yes\n* **Wheelchair accessible entrance:** Yes\n* **Wheelchair accessible restroom:** Yes\n* **Wheelchair accessible seating:** Yes\n\n**Payment options:**\n\n* **Credit Card:** Yes\n* **Debit Card:** Yes\n* **Cash Only:** No\n* **NFC:** Yes\n\n**Distance & Travel Time:**\n\n* 4745.7 kilometers\n* 43.5 hours"
            }
          },
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=12520445715080978741",
              "title": "Dough Burger",
              "text": "**About:**\n\n* **Type:** Restaurant\n* **Address:** 1721 Old Bayshore Hwy, San Jose, CA 95112, USA\n* **Open Now:** No\n* **Rating:** 4.2 (61 reviews)\n* **Phone:** (408) 515-0161\n* **Offers Takeout:** Yes\n* **Offers Delivery:** Yes\n* **Offers Dine-in:** Yes\n* **Good for Children:** Yes\n* **Live Music:** No\n* **Curbside Pickup:** Yes\n* **Serves Lunch:** Yes\n* **Serves Dinner:** Yes\n\n**Opening Hours (local time):**\n\n* Monday: 6:00 PM – 1:30 AM\n* Tuesday: 6:00 PM – 1:30 AM\n* Wednesday: 6:00 PM – 1:30 AM\n* Thursday: 6:00 PM – 1:30 AM\n* Friday: 6:00 PM – 3:00 AM\n* Saturday: 6:00 PM – 3:00 AM\n* Sunday: 6:00 PM – 1:30 AM\n\n**Parking options:**\n\n* **Free parking lot:** Yes\n* **Free street parking:** Yes\n\n**Accessibility:**\n\n* **Wheelchair accessible parking:** Yes\n* **Wheelchair accessible entrance:** Yes\n\n**Payment options:**\n\n* **Credit Card:** Yes\n* **Cash Only:** No\n\n**Distance & Travel Time:**\n\n* 4740.1 kilometers\n* 43.3 hours"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "startIndex": 267,
              "endIndex": 346,
              "text": "*   **Campus Burgers:** Open until 12:00 AM every night except Sunday (closed)."
            },
            "groundingChunkIndices": [
              1
            ],
            "confidenceScores": [
              0.76444983
            ]
          }
        ],
        "googleMapsWidgetContextToken": "widgetcontent/AcBXPQfo6pGrCXPJeN2xtADMw1TPz8Wzwm-..."
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 7,
    "candidatesTokenCount": 236,
    "totalTokenCount": 243,
    "trafficType": "ON_DEMAND",
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 7
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 236
      }
    ]
  },
  "modelVersion": "gemini-2.0-flash-001",
  "createTime": "2025-04-03T20:11:51.118341Z"
}
```

算繪 Google 地圖情境小工具

使用 Vertex AI 的「利用 Google 地圖建立基準」功能時，必須算繪 Google 地圖情境小工具。在任何以 Google 地圖為基礎的回覆中，都會有對應的 googleMapsWidgetContextToken，用於在生成的回覆附近顯示情境小工具。

  "googleMapsWidgetContextToken": "widgetcontent/AcBXPQdpWQWbap9H-OH8sEKmOXxmEKAYvff0tvthhneMQC3VrqWCjpnPBl4-Id98FGiA_S_t8aeAeJj0T6JkWFX56Bil8oBSR0W8JH3C_RSYLbTjxKdpxc9yNn6JcZTtolIRZon9xi6WpNGuSyjcIxWu2S0hwpasNOpUlWrG1RxVCB4WD1fsz_pwR236mG36lMxevXTQ_JnfdYNuQwQ4Lc3vn...<snip>...
  Ts5VJE_b3IC5eE_6wez0nh61r7foTUZpP7BXMwxR-7Wyfcj6x1v6mIWsFGr1o0p_HSAMNqWPg-aFVnkPLhAkOR6MaNZOfezTva-gxHlu7z_haFvYxcUE1qfNVQ",

顯示小工具的網頁必須使用 Google Maps JS API 的 Alpha 版。詳情請參閱「載入 Maps JavaScript API」。

您必須使用已啟用 Vertex AI「利用 Google 地圖建立基準」功能的 API 金鑰，才能載入 Google 地圖 JS API。

這個程式碼範例說明如何使用 HTML 建立小工具。

  <body>
    <gmp-place-contextual id="widget"></gmp-place-contextual>
  </body>

在 JavaScript 中，使用下列方法更新內容權杖：

function updateWidget(contextToken) {
  let widget = document.querySelector('#widget');
  widget.contextToken = contextToken;
}

您也可以使用下列程式碼動態建立小工具：

async function createWidget(contextToken) {
  await google.maps.importLibrary('places');
  let widgetContainer = document.querySelector('#wc');  // a div that contains the widget
  const placeContextualElement = new
      google.maps.places.PlaceContextualElement({ contextToken });
  widgetContainer.appendChild(placeContextualElement);
}

這個 HTML 程式碼範例說明如何使用設定選項，在兩種不同的版面配置 (compact 或 vertical) 之間切換。

    <gmp-place-contextual id="widget">
      <gmp-place-contextual-list-config layout="compact">
      </gmp-place-contextual-list-config>
    </gmp-place-contextual>

這個 HTML 程式碼範例說明如何停用地圖。

    <gmp-place-contextual id="widget">
      <gmp-place-contextual-list-config map-hidden>
      </gmp-place-contextual-list-config>
    </gmp-place-contextual>

這個 JavaScript 程式碼範例示範如何指定 compact 版面配置，以及如何隱藏地圖。

  const widgetConfig = new google.maps.places.PlaceContextualListConfigElement({
    layout: 'compact',
    mapHidden: true
  });
  widget.appendChild(widgetConfig);

後續步驟

  • 如要進一步瞭解如何根據資料調整 Gemini 模型，請參閱「根據資料調整模型」。
  • 如要進一步瞭解負責任的 AI 最佳做法和 Vertex AI 的安全篩選器，請參閱「負責任的 AI」。