Grounding Lite

Google 地圖平台 Grounding Lite 是一項支援模型內容通訊協定 (MCP) 的服務，可讓您輕鬆運用 Google 地圖中值得信賴的地理空間資料，為 AI 應用程式建立基準。MCP 伺服器提供的工具可讓 LLM 存取地點、天氣和路線功能。您可以在支援 MCP 伺服器的任何工具中啟用 Grounding Lite，試用這項功能。

工具

Grounding Lite 提供相關工具，讓 LLM 存取下列 Google 地圖功能：

  • 搜尋地點：要求地點相關資訊，並取得 AI 生成的地點資料摘要，以及摘要中每個地點的地點 ID、經緯度座標和 Google 地圖連結。您可以將傳回的地點 ID 和經緯度座標與其他 Google 地圖平台 API 搭配使用，在地圖上顯示地點。
  • 查詢天氣：要求提供天氣資訊，並傳回目前狀況、每小時預報和每日預報。

  • 計算路線：要求兩地點之間的行車或步行路線資訊，並傳回路線距離和時間資訊。

啟用 Maps Grounding Lite MCP 伺服器後，LLM 就能呼叫伺服器公開的新工具，傳回上述資料類型的額外基礎資訊。雖然 LLM 可以使用這項額外資訊做為脈絡，但 LLM 最終生成的回覆可能不會包含 MCP 伺服器傳回的確切資訊。請務必驗證生成的回覆內容是否準確。

帳單與配額

在實驗階段，使用 Grounding Lite 不會產生費用。不過，Grounding Lite 提供的工具適用下列配額：

  • 搜尋地點：每項專案每分鐘 100 個查詢。每項專案每天 1,000 次查詢。
  • 查詢天氣：每項專案每分鐘 300 次查詢。
  • 計算路徑：每項專案每分鐘 300 個查詢。

政策和服務條款

Grounding Lite 須遵守《Google 地圖平台服務條款》，包括這項服務的服務專屬條款。本節說明 Grounding Lite 的額外服務使用規定，包括相容的 LLM 和來源出處規定。

相容 LLM 的需求條件

您只能搭配符合《Google 地圖平台服務條款》的 LLM 使用 Grounding Lite。

舉例來說，您有責任確保 Google 地圖內容不會由您選擇使用的 LLM 進行快取、儲存或用於改善 LLM。使用 Grounding Lite 前，請先詳閱您打算搭配 Grounding Lite 使用的任何模型服務條款。您不得將 Grounding Lite 與任何模型搭配使用，因為這類模型會將輸入模型的資料用於模型訓練或改良。您有責任確保使用模型時完全遵守《Google 地圖平台服務條款》中對 Google 地圖內容的限制，包括服務專屬條款。

Google 地圖來源的著作權聲明規定

Grounding Lite 的每則工具回覆都會附上來源。使用 Grounding Lite 提供的工具呈現結果時，您必須以符合下列規定的方式，加入相關聯的 Google 地圖來源：

  • Google 地圖來源必須緊接在來源支援的生成內容之後。這類生成內容也稱為「有根據的輸出內容」。
  • Google 地圖來源必須在一次使用者互動中顯示。

「搜尋地點」工具的來源

search_places 工具的 places 欄位會提供支援summary的來源。如果是 places，系統會傳回下列中繼資料：

  • place (資源名稱)
  • id
  • location
  • googleMapsLinks

每個地點都必須產生符合下列規定的連結預覽畫面：

  • 請按照地圖精簡模式文字出處註明規範，將每個來源歸功於 Google 地圖。
  • 顯示 Open Graph 中繼資料 og:title 提供的來源網頁標題，該中繼資料 googleMapsLinks 包含在回覆中。
  • 使用回應中的 places.googleMapsLinks.placeUrl 連結至來源。

設定 LLM 使用 MCP 伺服器

如要使用 Grounding Lite，您必須先取得已啟用 Maps Grounding Lite API 服務的 API 金鑰。接著，您可以設定 LLM 存取 MCP 伺服器。 Grounding Lite MCP 伺服器使用可串流的 HTTP 傳輸。

建立或設定 API 金鑰

只要在金鑰上啟用 Maps Grounding Lite API 服務，您就可以搭配使用現有的 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 地圖平台入門指南」中的步驟，建立或設定 API 金鑰。

API 金鑰應使用 X-Goog-Api-Key 標頭傳遞至 MCP 伺服器。您需要在 LLM 的 MCP 工具設定中，將此指定為自訂 HTTP 標頭。

設定 LLM 以存取 Grounding Lite MCP 伺服器

取得已啟用 Maps Grounding Lite API 服務的 API 金鑰後，請按照對應的 MCP 設定說明文件，並使用 Grounding Lite MCP 伺服器網址：https://mapstools.googleapis.com/mcp，設定 LLM 存取 MCP 伺服器。

使用 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 詢問地圖相關問題。舉例來說，試著說出「幫我推薦 Mountain View 的餐廳」，這應該會代表你呼叫 search_places 工具。

提供意見

如要對 Grounding Lite 提供意見，請填寫下列表單：