Gemini API Google Maps Grounding(地圖接地)怎麼用:結合真實地點評分、路線與周邊資訊構建位置助手

做旅行規劃、門店導購或本地生活助手怎麼防模型編造假店名?本文詳解 Gemini API 掛載 google_maps 工具、傳入經緯度座標、提取 place_id 與評分連結,以及前端來源歸屬展示要求。

NNathaniel bigo··原創首發·AI 輔助撰寫
11 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 其他 帳號

結論先說

  1. 開啟只需在 tools 掛載 GoogleMaps 工具:模型檢測到提示詞含有地理位置、商圈、距離或門店設施意圖時,會自動檢索 Google Maps 超 2.5 億個真實地點庫,無需你手動拼裝複雜的 Places REST API 查詢參數。
  2. 涉及「附近 / 步行十分鐘內」提問時必須傳 lat_lng 經緯度:通過 ToolConfig 裏的 RetrievalConfig 傳入用戶當前座標,模型才能以真實位置為圓心篩選周邊商戶。
  3. 從 grounding_chunks 提取結構化門店連結與 place_id:返回體除自然語言介紹外,還在 grounding_metadata 中附帶每個引用地點的真實店名、地圖跳轉 uri 與唯一 place_id。
  4. 支持與 Google Search 聯網搜尋同時開啟:一個管真實營業時間、評分與用戶評價摘要,一個管近期臨時封路、音樂節或新店快閃新聞,互補覆蓋本地生活場景。
  5. 谷歌開發帳號與主力編程會員入口:在 Google AI Studio 與 Cloud 控制檯調試地圖接地需準備個人谷歌帳號,缺號可查看本站 谷歌帳號購買說明(含即買即發的 谷歌電郵成品號),跨平台主力編程會員總覽見 AI 會員充值中心。

Gemini 地圖接地四步接入流程

圖:本站根據 Google Gemini API 文檔:Grounding with Google Maps 整理的示意圖

本文根據 Google Gemini API 官方文檔《Grounding with Google Maps》《Gemini Developer API Pricing》整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Google 官方網站。

適用於誰

  • 開發出境旅遊行程助手、酒店周邊推薦、房產配套分析或線下門店選址問答產品的團隊;
  • 直接讓純文本大模型推薦餐廳時,頻繁遇到「早已倒閉的老店、張冠李戴的營業時間或憑空捏造的地址」的人;
  • 想在拿到自然語言推薦的同時,提取標準 place_id 與地圖直鏈渲染成可點擊店鋪卡片的前端與全棧工程師。

一、Python 代碼示例:掛載 google_maps 與傳入當前經緯度

先確保本機已安裝官方 google-genai SDK(安裝與密鑰配置見 Gemini API Python 調用教學;若你在對比個人開發者端與企業雲端的差異,可參閱 Google AI Studio 和 Vertex AI 的 Gemini API 有什麼區別)。

完整帶座標偏置的周邊檢索代碼如下:

python
from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="推薦附近步行 15 分鐘內、週末上午 9 點營業且適合帶筆記本辦公的安靜咖啡館。",
    config=types.GenerateContentConfig(
        tools=[types.Tool(google_maps=types.GoogleMaps(enable_widget=True))],
        tool_config=types.ToolConfig(
            retrieval_config=types.RetrievalConfig(
                lat_lng=types.LatLng(latitude=35.6580, longitude=139.7016)
            )
        ),
    ),
)

print(response.text)

如果不傳 retrieval_config 裏的經緯度,只要你在提示詞正文寫清明確地標(例如「東京澀谷站周邊」或「舊金山聯合廣場附近」),模型同樣能從文本中識別地理中心並觸發地圖接地。

二、解析 place_id、地圖連結與交互掛件令牌

只把模型生成的純文本直接貼到介面上不夠直觀,通過遍歷 grounding_metadata,你可以把每個推薦地點做成帶跳轉連結的卡片(對比普通網頁搜尋的元數據格式見 Gemini API 聯網搜尋怎麼調):

python
meta = response.candidates[0].grounding_metadata
if meta and meta.grounding_chunks:
    for chunk in meta.grounding_chunks:
        if chunk.maps:
            print(f"店名: {chunk.maps.title}")
            print(f"Place ID: {chunk.maps.place_id}")
            print(f"地圖直鏈: {chunk.maps.uri}")

if meta and meta.google_maps_widget_context_token:
    print("前端地圖組件令牌已返回,可傳給 <gmp-place-contextual> 渲染")

這裏有兩個關鍵工程細節需要留意:

  1. 合規展示來源歸屬(Attribution):按 Google Maps Grounding 服務條款規定,面向終端用戶展示基於地圖接地生成的商戶詳情、評論摘要或評分時,必須在對應位置清晰展示可點擊的 Google Maps 來源連結(即 chunk.maps.uri),或者在前端加載 Maps JavaScript API 的 <gmp-place-contextual> 組件傳入 google_maps_widget_context_token 渲染官方卡片。
  2. 與 google_search 聯合使用:當用戶問「今晚去某某體育館看演唱會,散場後晚上 11 點周邊還有哪些營業的拉麵店」時,可在 tools 列表同時放入 GoogleMaps() 與 GoogleSearch(),讓模型先通過網頁搜尋核實演唱會散場時間,再用地圖工具篩深夜營業門店。
谷歌開發帳號與全棧編程訂閱提示:開通 AI Studio 與地圖相關雲服務需要狀態正常的個人谷歌帳號,若註冊受阻可在本站選購已配好兩步驗證的 谷歌電郵成品號(詳見 谷歌帳號購買頁);編寫前端地圖卡片與行程規劃邏輯時,還可搭配免境外卡開通的 Claude Code 或 ChatGPT Plus。

地圖接地無結果與展示合規排查

圖:本站根據 Google Gemini API 文檔:Grounding with Google Maps 整理的示意圖

三、計費口徑與不適合交給地圖接地的場景

在成本控制方面,地圖接地與聯網搜尋類似,屬於在常規輸入輸出 Token 之外獨立核算的官方接地工具(最新免費請求配額與每千次請求單價請以 Gemini API 價格說明 與官方 Pricing 頁面為準):

  • 只有實際觸發地圖檢索才計工具次數:同一對話裏用戶先問「去日本旅遊帶什麼插頭轉換器」,模型無需查地圖,不計接地調用;下一句追問「京都站旁有哪些高分宇治抹茶店」才會觸發計次。
  • 不替代毫秒級實時路況導航與打車計價接口:Google Maps Grounding 的強項是基於海量評論、設施標籤與營業時間做多條件自然語言篩選與行程推理;如果你需要做精確到秒的駕車轉向導航(Turn-by-turn)或成百上千個配送點的矩陣路徑規劃,仍應直接調用 Google Maps Platform 的 Routes API。

常見問題

問:我已經傳了 google_maps 工具,為什麼返回對象的 grounding_chunks 是空的?

答:首先檢查提問是否包含明確的地點、商戶或距離訴求;其次確認所選模型版本在官方支持矩陣內(部分極早期快照或純代碼模型不支持地圖接地);最後核查提問區域是否在 Google Maps POI 正常覆蓋範圍內。

問:拿到的 place_id 可以存進我們自己的業務數據庫長期緩存嗎?

答:Google Maps 平台條款通常允許長期存儲純粹的 place_id 字符串以便後續重新定位該地點,但對於接口返回的商戶名稱、評分、評論文本與經緯度等具體內容,一般有嚴格的緩存有效期限與不得用於脫離 Google 生態重建競品圖庫的條款約束,上線前請務必核對官方服務條款。

問:開啟地圖接地時還能同時傳自定義業務 Function Calling 嗎?

答:在較新的 Gemini 模型與 SDK 中已逐步支持內置接地工具與自定義函數的組合編排,若你的具體模型版本報工具類型衝突,可將流程拆為兩步:第一步先調地圖接地拿到候選門店與 place_id,第二步再調內部預訂或庫存函數。

問:國內沒有外幣卡怎麼買谷歌帳號或訂閱 Claude、ChatGPT 會員輔助開發,支持開報銷發票嗎?

答:可前往本站 谷歌帳號購買頁、Claude Code 充值頁 或 AI 會員充值總覽 下單,支持支付寶、微信支付與 AlipayHK,會員訂閱支持免交帳號密碼的自助卡密兌換,企業採購支持開具國內增值稅發票;實時價格與售後邊界(掉訂閱按剩餘天數折退,封號不在質保範圍)以各商品頁說明為準。

相關教學

參考資料

  • Google Gemini API 官方文檔:Grounding with Google Maps — https://ai.google.dev/gemini-api/docs/maps-grounding
  • Google Gemini API 官方文檔:Grounding overview — https://ai.google.dev/gemini-api/docs/grounding
  • Google Gemini API 官方文檔:Gemini Developer API Pricing — https://ai.google.dev/gemini-api/docs/pricing

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同模型

  1. 01

    用 Google Takeout 單獨備份導出 NotebookLM 筆記本與 Gemini 記錄:只勾選指定服務不下載整個雲端硬碟的步驟

    想把 NotebookLM 裏的幾十個研究筆記本、來源副本與音頻概覽,連同 Gemini 聊天記錄一起備份到本地,又怕 Google Takeout 把整個雲端硬碟和相冊全打包?本文講清先取消全選、精準勾選兩項服務、解壓目錄查看與跨號遷移的做法。

    Gemini0
  2. 02

    Google Workspace 企業/教育版管理員怎麼在後台給成員開啟 Gemini 應用、NotebookLM 與設定年齡訪問權限

    團隊成員或學校師生登入 Google Workspace 帳號時提示無權使用 Gemini 或打不開 NotebookLM?本文按 Google 管理控制檯官方文檔整理服務開關路徑、組織部門(OU)與群組放行、18 歲年齡訪問權限設定及對話保留合規配置。

    Gemini0
  3. 03

    安卓手機預設助手換成 Gemini 後設鬧鐘、發短訊或控制智能家居失靈怎麼辦:Workspace 與實用程序擴展開啟步驟

    安卓手機把預設語音助手從 Google Assistant 換成 Gemini 後,喊它定鬧鐘、開手電筒、發短訊或開關智能燈全都沒反應?本文按官方幫助中心整理實用程序(Utilities)、Google Home 與 Workspace 關聯應用開啟步驟及鎖屏放行設定。

    Gemini0
  4. 04

    Gemini 寫長代碼或長文檔到一半突然停住、格式截斷怎麼無縫續寫:錨點接續指令與 Canvas 分塊修改技巧

    讓 Gemini 寫幾百行代碼或萬字長文時經常寫到一半突然停住、Markdown 代碼塊沒閉合,直接回「繼續」又重頭抄一遍?本文整理字面錨點續寫指令、代碼塊防亂碼補齊法與 Canvas 局部圈選修改工作流。

    Gemini0
  5. 05

    NotebookLM 中文音頻播客(Audio Overview)高階玩法:用自定義引導詞控制對談深度、受眾水平與重點章節(附模板)

    NotebookLM 生成的中文音頻播客總是泛泛而談、漏掉核心章節或夾雜生僻英文縮寫?本文按官方幫助中心整理來源勾選過濾、四種播客格式搭配與三維自定義引導詞寫法,附 4 套可直接複製的中文控場模板。

    Gemini0
  6. 06

    NotebookLM 添加 YouTube 影片、網頁或掃描版 PDF 提示「無法導入來源」怎麼辦:無字幕、反爬與純圖 PDF 逐項解決

    往 NotebookLM(Gemini Notebook)塞 YouTube 連結、外文網頁或掃描教材時總是亮紅歎號提示無法導入來源?本文按官方幫助中心逐項排查無字幕影片、反爬動態頁與加密純圖 PDF 的替代導入步驟。

    Gemini0

同產品的其他教學

  1. 01

    iPhone 操作按鈕(Action Button)或鎖屏小組件一鍵開啟 ChatGPT / Gemini 實時語音對話配置教學

    每次在 iPhone 上練口語或語音提問都要解鎖、找圖標、再點耳機按鈕太繁瑣?本文整理利用 iPhone 操作按鈕(Action Button)、iOS 18 鎖屏底部控制項、控制中心與背面輕點一鍵直達 ChatGPT 實時語音或 Gemini Live 的完整步驟。

    ChatGPTGemini0
  2. 02

    Firebase Studio(原 Project IDX)是什麼、怎麼用:瀏覽器雲端全棧開發環境搭配 Gemini 智能體實戰

    以前收藏的 Project IDX 網址為什麼跳到了 Firebase Studio?本文按 Google 官方文檔講清它的全棧雲端定位、App Prototyping 原型智能體、Code 視圖切換、.idx/dev.nix 環境定製與免費工作區上限。

    Gemini其他 AI 工具0
  3. 03

    Google Colab 內置 Gemini 編程助手怎麼用:免費雲端 GPU 筆記本自動生成數據分析代碼、修報錯與限額說明

    不用配本地 Python 環境,怎麼在 Google Colab 雲端筆記本里免費用 Gemini 自動寫數據分析代碼、一鍵修復紅字報錯並跑 Data Science Agent?本文整理四大入口用法、Secrets 密鑰管理與免費版限額。

    Gemini其他 AI 工具0
  4. 04

    Gemini API Token 計數(count_tokens)與多模態計費規則:圖片解像度、音頻秒數與影片幀率怎麼折算 Token

    傳一張高清截圖或一段 10 分鐘影片給 Gemini API 到底扣多少 Token?本文按官方文檔拆解 258 圖片切片、每秒 32 音頻與每秒 263 影片折算公式,附 count_tokens 免費預估與降本代碼。

    Gemini0
  5. 05

    Gemini API 回答被安全策略攔截(SAFETY / PROHIBITED_CONTENT)怎麼辦:閾值調節邊界與合規提示詞排查

    調用 Gemini API 翻譯文檔或分析安全日誌時返回空白、報 finish_reason: SAFETY 或 PROHIBITED_CONTENT 怎麼辦?本文詳解四類可調安全閾值代碼寫法、不可關閉的硬性紅線區別與誤報排查步驟。

    Gemini0
  6. 06

    Gemini API 圖像生成與多輪改圖怎麼調:用 google-genai SDK 出圖、局部修改與寬高比控制參數

    怎麼用 Python 代碼調用 Gemini API 生成高清配圖並像聊天一樣連續局部改圖?本文詳解 google-genai SDK 原生生圖代碼、多輪對話改圖、參考圖融合與 aspect_ratio 寬高比配置。

    Gemini0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~