Gemini API新功能:接入谷歌地图,AI懂地理了
功能演示:AI与地图的联动效果
Google AI Studio 里有现成的 demo 可玩,点击就能体验「AI 对话+地图数据」的联动效果——支持实时交互,还能直接修改代码添加自己的功能(比如加 UI 组件、整合其他工具)。
演示视频直达:Google AI Studio 官方demo页面(含实时交互功能,基于Gemini Live API开发)
快速上手:Python代码示例
不用复杂配置,只需在 Gemini API 请求中启用「谷歌地图工具」,3步就能调用。下面是完整示例(附中文注释,替换 API 密钥即可用):
# 1. 导入依赖库
from google import genai
from google.genai import types
# 2. 初始化客户端(替换成你的API密钥)
client = genai.Client(api_key="你的Gemini API密钥")
# 3. 定义查询和调用参数
prompt = "这附近15分钟步行可达的最佳意大利餐厅有哪些?"
# 发送请求并获取响应
response = client.models.generate_content(
model='gemini-2.5-flash-lite', # 推荐轻量版,平衡性能和成本
contents=prompt,
config=types.GenerateContentConfig(
# 启用谷歌地图工具
tools=[types.Tool(google_maps=types.GoogleMaps())],
# 可选:指定地理位置(这里以洛杉矶为例,替换成你的经纬度)
tool_config=types.ToolConfig(retrieval_config=types.RetrievalConfig(
lat_lng=types.LatLng(
latitude=34.050481, # 纬度
longitude=-118.248526 # 经度
))),
),
)
# 打印AI的回答
print("AI推荐结果:")
print(response.text)
# 打印地图数据来源(方便追溯信息可靠性)
if grounding := response.candidates[0].grounding_metadata:
if grounding.grounding_chunks:
print("\n数据来源(谷歌地图):")
for chunk in grounding.grounding_chunks:
print(f'- [{chunk.maps.title}]({chunk.maps.uri})')
额外技巧:添加可交互地图组件
响应结果里会包含「上下文令牌」,用它能获取可交互的地图组件——直接嵌入你的 App 界面,用户能看到照片、评论、营业时间等细节,体验和谷歌地图原生界面一致。
3大实用场景,直接落地
Gemini + 谷歌地图的组合,在旅行、房产、零售等领域都是「降维打击」,这3个场景已经过实测,效果拉满:
1. 旅行规划:生成可执行的全天行程
用户提出「规划旧金山一日游,含金门大桥、博物馆及餐饮」,AI结合地图数据输出:
- 优化路线顺序(减少交通耗时)
- 实时营业信息(规避临时闭馆景点)
- 多交通方式对比(步行/公交/自驾时间)
2.房产/生活:精准匹配个性化需求
房产 App 可以帮家庭找「适合带娃的出租房」,AI 会通过地图定位:
- 周边的学校、游乐场、公园位置
- 通勤时间(到父母家/公司的距离)
- 周边配套(超市、医院的步行可达性)
3.本地查询:秒答具体地点细节
类似「第一大街和主街拐角的咖啡馆有没有户外座位?」这种问题,AI 会直接调取谷歌地图的用户评论、商家信息,给出明确答案,还能附照片佐证。
进阶玩法:地图+搜索双工具联动
把「谷歌地图」和「谷歌搜索」工具同时启用,能让 AI 响应更全面——两者分工明确,1+1>2:
● 谷歌地图:提供结构化数据(地址、营业时间、评分、位置)
● 谷歌搜索:提供时效性内容(活动日程、新闻、演出时间)
案例:查询「Beale街的现场音乐演出」
AI 会自动拆分任务:
1. 用地图工具获取 Beale 街所有酒吧/场馆的「营业时间」;
2. 用搜索工具获取这些场馆「当天的演出StartTime」;
3. 整合结果给出「按演出时间排序的推荐列表」。
内部测试显示,这种组合比单独用某一个工具,响应质量提升40%以上。
资源汇总:立即开始开发
「Gemini + 谷歌地图」功能已全面开放,支持最新版 Gemini 模型,开发者可根据需求选不同模型(平衡性能和成本)。这些资源帮你快速落地:
1. 官方文档:Gemini地图功能完整指南(含参数详解、错误处理
2. 可修改demo:Google AI Studio演示应用(支持直接修改代码
3. 代码 cookbook:Gemini API食谱(含地图+搜索组合案例)
4. 定价说明:工具定价详情(按需选择,成本可控)
总结:AI地理能力的核心价值
这波更新本质是「给 AI 装上地理感知能力」——以前需要手动对接谷歌地图 API、处理数据格式,现在一句话提示就能搞定。不管是做 To C 的生活 App,还是 To B 的物流、零售系统,都能靠它提升效率。
目前唯一要注意的是:地理位置精度会影响结果质量,尽量给 AI 提供准确的经纬度(比如通过用户手机定位获取)。



