现在，开发者可以在 Gemini API 中启用 Google Maps 工具，将丰富、实时的地理空间数据作为模型生成内容的基座，从而构建具备地理位置感知能力的 AI 应用。这项功能将 Gemini 模型的推理能力与来自全球超过 2.5 亿个地点的数据相结合，为打造新一代强大的地理空间感知 AI 产品提供了可能。

与 Google Search Grounding 类似，Google Maps Grounding 能够在用户查询涉及地理位置信息时，为模型提供准确、可靠的最新数据，从而显著提升回答的质量。

快速上手

在您的 Gemini API 请求中，只需启用 Google Maps 工具即可开始使用。

以下是一个使用 Python SDK 的示例代码：

import google.generativeai as genai

# 配置你的 API 密钥
genai.configure(api_key="YOUR_API_KEY")

# 创建模型实例并启用 Google Maps 工具
model = genai.GenerativeModel(
    model_name='gemini-1.5-pro-latest',
    tools=['google_maps'])

# 发起聊天请求
chat = model.start_chat()
response = chat.send_message(
    "给我推荐一些旧金山唐人街附近适合举办生日派对的中餐馆，并说明理由。")

print(response.text)

可视化地图结果

为了更直观地展示基于地图的搜索结果，API 还会返回一个上下文令牌（context token）。您可以使用此令牌生成一个可交互的地图小组件（widget），并将其嵌入到您的应用界面中。这为用户提供了熟悉的地图体验，其中包含相关的照片、评论和其他详细信息。

(图片描述：一个展示了旧金山唐人街多家餐厅位置的 Google Maps 小组件，包含餐厅名称、评分和照片等信息。)

应用场景与优势

借助 Google Maps Grounding，开发者可以在旅行、房地产、零售和物流等多个领域创造出更直观、更有帮助的用户体验。模型能够自动检测查询中的地理背景，并利用 Google Maps 的数据（如地点信息、用户评论等）来生成更可靠的回答。您还可以通过提供经纬度坐标，将搜索结果本地化到特定的地理区域。

以下是一些典型的应用场景：

  • 详细的行程规划 不再仅仅是简单的地点罗列。旅行应用现在可以生成详尽的单日计划，包含地点间的距离、预估行程时间以及当地的实用信息。例如，用户可以提问：“帮我规划一天的旧金山行程，我想看金门大桥，参观一个博物馆，再吃一顿美味的晚餐。” 应用可以返回一个完整可行的行程方案，甚至包括了最新的营业时间和节假日安排。

  • 超本地化的个性推荐 根据用户的偏好和指定的位置，提供量身定制的建议。例如，一个房地产应用可以帮助家庭寻找适合儿童居住的社区，通过识别附近的游乐场、学校和公园来推荐房源。

  • 基于本地信息的问答 通过整合用户评论和其他地图数据，回答关于特定地点的详细问题。例如，对于“第一大道和主街拐角的那家咖啡馆有户外座位吗？”这样的查询，现在可以得到一个基于 Google Maps 数据的准确回答。

结合 Maps 与 Search Grounding 发挥更强威力

为了构建功能最强大、上下文感知能力最强的应用，您可以在同一个 API 请求中同时启用 Google Maps Grounding 和 Google Search Grounding。

  • Google Maps 提供结构化的事实数据，如地址、营业时间、用户评分等。
  • Google Search 提供来自全网的描述性、时效性信息，如活动日程、新闻和相关文章。

例如，当用户询问“比尔街有哪些现场音乐表演”时，结合使用这两种工具，模型可以利用 Maps 数据获取场馆的营业时间，同时利用 Search 数据查找当晚演出的具体开始时间。

内部评估表明，与单独使用任一工具相比，同时启用 Maps 和 Search Grounding 能够显著提升模型响应的质量。

开始构建

Google Maps Grounding 功能现已正式可用，并支持我们最新的模型。您可以根据应用的需求，在性能和成本之间选择最合适的模型。欢迎查阅官方文档或在 Google AI Studio 中体验演示应用，立即开始构建您的地理空间感知 AI 应用。

👉 如果你需要 ChatGPT 代充 / Claude / Claude Code / 镜像 / 中转 API：