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 条评论

登录 后参与评论

还没有评论,来抢沙发~