Places API 的政策

本文档列出了适用于使用 Places API（新版）开发的所有应用的具体要求，包括作为该 API 一部分的自动补全（新版）服务。如需了解面向 Google 地图开发者的更多常规信息，请参阅 Google Maps Platform 服务条款。

提供使用条款和隐私权政策

如果使用 Places API 开发应用，您必须在应用中提供使用条款和隐私权政策，并确保相关内容符合您与 Google 签订的协议中规定的准则：

  • 《使用条款》和《隐私权政策》必须可公开访问。
  • 您必须在应用的《使用条款》中明确说明，用户使用应用时须遵守 Google 服务条款。
  • 您必须在《隐私权政策》中注明您使用的是 Google Maps API，并且以提述方式将 Google 隐私权政策纳入其中。

《使用条款》和《隐私权政策》的建议显示位置因应用平台而异。

移动应用

如果开发的是移动应用，建议在相关应用商店的应用下载页面上以及应用的设置菜单中提供指向《使用条款》和《隐私权政策》的链接。

Web 应用

如果开发的是 Web 应用，建议在网站的页脚位置提供指向《使用条款》和《隐私权政策》的链接。

预取、缓存或存储内容

如果应用是使用 Places API 开发的，则须遵守您与 Google 签订的协议条款。根据您签订的协议条款，除了条款中规定的少数情况之外，您不得预取、存储、缓存任何内容或将其编入索引。

请注意，用于唯一标识地点的地点 ID 可不受缓存限制。因此，您可以无限制地存储地点 ID 值。系统会在 API 响应的 place_id 字段中返回地点 ID。如需了解如何保存、刷新和管理地点 ID，请参阅地点 ID 指南。

显示 Places API 结果

您可以在 Google 地图上显示 Places API 结果，也可以不使用地图显示结果。如果您想要在地图上显示地点 API 结果，则必须在 Google 地图上显示。禁止在 Google 地图以外的地图平台上使用 Places API 数据。

如果应用在 Google 地图上显示数据，则需要包含 Google 徽标，且不得修改。如果应用显示 Google 数据时与 Google 地图在同一屏幕上，则不需要向 Google 提供详细的提供方信息。

如果应用在页面或视图上显示数据时 Google 地图并未一同显示，您必须在显示这些数据的同时显示 Google 徽标。例如，如果应用在一个标签页上显示 Google 数据，而包含这些数据的 Google 地图位于另一个标签页上，则第一个标签页上必须显示 Google 徽标。如果应用使用搜索字段（无论是否具有自动补全功能），则徽标必须在同一行内显示。

Google 徽标应放置在地图左下角，提供方信息应放置在右下角，两者都应显示在地图上，而不是位于地图下方或应用内的其他位置。在下面的地图示例中，Google 徽标位于地图左下角，提供方信息位于右下角。

一张地图，图像左下角带有 Google 徽标

以下 zip 文件包含不同尺寸的 Google 徽标，分别适用于桌面版、Android 版和 iOS 版应用。您不得以任何方式修改这些徽标或调整其尺寸。

下载：google_logo.zip

请勿修改提供方信息。请勿移除、裁剪掉提供方信息，或对其进行模糊处理。您不能内嵌使用 Google 徽标（例如，“这些地图来自 [Google_logo]”）。

确保提供方信息靠近内容。如果不是以直接嵌入方式使用 Google 图像屏幕截图，那么显示的标准提供方信息应与图片中的内容相同。如有必要，您可以自定义提供方信息文字的样式和位置，只需确保文字紧邻内容且清晰可辨，能够让普通观众或读者轻松阅读。您不得将提供方信息移到内容区域之外的位置，例如放在图书末尾、文件或节目的人员名单或网站的页脚中。

注明第三方数据提供方。地图产品上的一些数据和图片来自 Google 以外的提供方。如果使用此类图像，提供方信息文字中必须提及“Google”和相关数据提供方，例如“地图数据：Google、Maxar Technologies”。如果图像中提及第三方数据提供方，那么提供方信息中不应仅包含“Google”或 Google 徽标。

如果要使用 Google Maps Platform 的设备实际无法显示提供方信息，请与 Google 销售团队联系，了解您的使用情形适用的许可。

其他提供方信息要求

请按照以下说明检索第三方提供方信息，然后在应用中显示提供方信息。

从 Place 对象中检索提供方信息

如果您的应用显示通过使用地点 ID 调用地点详情获取的信息，则还必须显示获取的地点详情的第三方提供方信息。

响应 Place 对象中的归因由 Attribution 对象表示。如需将 Attribution 添加到响应中，请在请求的字段掩码中添加 places.attributions（附近搜索和文本搜索）或 attributions（地点详情）。

Attribution 对象的字段是包含提供方信息的 provider 和 providerUri 的字符串，如果没有可显示的提供方信息，则为空字符串。

显示照片的提供方信息

如果应用会显示照片，您必须显示每张照片所有者的作者信息。

如果响应中包含 Place 对象，则照片的详细信息包含在 photos 数组中。若要将 photos 数组添加到响应中，请在请求的字段掩码中添加 places.photos（附近搜索和文本搜索）或 photos（地点详情）。

photos 数组的每个元素都是 Photo 的实例，其中包含类型为 AuthorAttribution 的 authorAttributions 数组。

AuthorAttribution 对象的字段是包含提供方信息的 displayName、uri 和 photoUri 的字符串，如果没有可显示的提供方信息，则为空字符串。

显示评价

响应中的 Place 对象最多可以包含五条评价。您可以选择在应用中显示这些评价。

显示 Google 用户提供的评价时，您必须将作者姓名放在紧邻评价的位置。如果 Review 对象的作者信息字段中提供了作者照片及个人资料链接等信息，我们建议您一并添加。下图显示了某个公园的评价示例：

显示作者信息

Google 还建议您向最终用户显示评价的排序方式。

响应 Place 对象中的每条评价都由 Review 对象表示。若要将 Review 对象添加到响应中，请在请求的字段掩码中添加 places.reviews（附近搜索和文本搜索）或 reviews（地点详情）。

Review 对象的字段包含提供方信息，如果没有可显示的提供方信息，则为空。

搜索结果归因

在欧洲，如果使用 Google 的纯粹排名，搜索产品必须提供说明文本，且点击次数不得超过 1 次，说明决定搜索结果排名的主要因素及其权重。说明文字：

标题：关于这些结果

正文：当您搜索某个地点附近的商家或场所时，Google 地图会显示本地搜索结果，并且会结合多种因素（主要是相关性、距离和知名度）帮助您找到最符合搜索条件的结果。

按钮 1：了解详情
“了解详情”文字应链接到帮助中心文章。

按钮 2：确定

AI 赋能的摘要

在应用中显示 AI 赋能的摘要（包括地点、区域和评价摘要）时，您必须执行以下操作：

  • 显示以下所述的必要提供方信息、举报链接和参考链接。
  • 最终用户必须能够阅读 Google 地图提供的完整摘要文本。

显示 AI 生成的摘要披露文本

显示任何类型的 AI 赋能的摘要时，请务必在摘要下方立即添加本地化的披露文本（在响应正文的 disclosureText 字段中提供）。切勿修改或补充 API 提供的披露文本。

所有 AI 赋能的摘要类型的披露声明
图 1：三种 AI 赋能的摘要类型下方正确显示的披露文本。

地点和区域摘要的其他要求

应用中显示的地点和区域摘要必须附带以下文字和必需的链接：

文本 要求
关于此摘要 如需了解“Google 如何获取和使用本地商家信息中的信息”，请访问以下链接：https://support.google.com/local-listings/answer/9851099。
举报摘要

您可以使用响应中 flagContentUri 字段中包含的链接，向 Google 报告摘要内容方面的问题。

注意：无论身在何处，您通过 Places API（新版）提供的 AI 生成摘要均须遵守 Google 的内容和产品政策。您必须通知最终用户，如果他们想举报应根据适用法律从 Google 服务中移除的内容，应使用提供的内容举报网址 (flagContentUri) 进行举报。
地点和区域摘要的披露声明
图 2：显示了 AI 赋能的区域摘要，其中包含使用菜单提供给最终用户的必需关联链接。

评价摘要要求

应用中显示的评价摘要必须带有标题“评价摘要”。此外，您必须使用以下文字和必要的链接：

文本 要求
关于此摘要 如需了解“Google 如何获取和使用本地商家信息中的信息”，请访问以下链接：https://support.google.com/local-listings/answer/9851099
举报摘要

使用响应 flagContentUri 字段中包含的链接。

注意：无论身在何处，您通过 Places API（新版）提供的 AI 生成摘要均须遵守 Google 的内容和产品政策。您必须通知最终用户，如果他们想举报应根据适用法律从 Google 服务中移除的内容，应使用提供的内容举报网址 (flagContentUri) 进行举报。
查看评价 使用响应 googleMapsLinks.reviewsUri 字段中包含的链接。
评价摘要的披露声明
图 3：显示了 AI 赋能的评价摘要，其中包含使用菜单提供给最终用户的必要关联链接。

适用于汽车用例的显示屏指南

为了确保驾驶员安全，Google 建议在停车模式下使用 AI 生成摘要来提供汽车体验。如果在驾车模式下呈现摘要，屏幕上的信息应简单、清晰且简洁，以确保驾驶员能够快速将注意力重新集中到道路上：

  • 不超过 3 行
  • 不得超过 120 个字符或 24 个字词
  • 正面最小尺寸为 24dp

尤其是在汽车场景中，开发者有责任以安全且符合所有当地法律法规的方式呈现 AI 赋能的摘要。

Google 提供方信息样式指南

如果无法使用可下载的 Google 徽标，请按照以下样式指南使用 CSS 和 HTML 添加 Google 提供方信息。

留白空间

完整标识周围的留白空间应等同或超过 Google 中“G”的高度。

提供方信息和 Google 徽标之间的间距应为“G”宽度的一半。

易读性

署名应始终清晰可辨，而且颜色应适合给定背景。务必要为所选择的徽标变体提供足够的对比度。

颜色

如果是白色或浅色背景，文字应使用 Google Material Gray 700，黑色色调最高介于 0% 到 40% 之间。

Google
#5f6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

如果是深色背景，而且是摄影作品或简单图案，应使用白色文字标注署名和提供方信息。

Google
#ffffff
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

字体

使用 Roboto 字体。

示例 CSS

将以下 CSS 代码段应用于文字“Google”后，“Google”以适当的字体、颜色和间距显示在白色或浅色背景上。

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5f6368;