Places API 的政策和提供方信息

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

政策

本部分介绍了与 Places API 相关的政策。政策提供了实用的 实现指南和要求，可帮助您正确使用本服务 ，并符合 Google Maps Platform 的预期。

缓存限制的例外情况

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

欧洲经济区国家和地区

对于账单邮寄地址位于 欧洲经济区 (EEA) 的客户，本产品有不同的服务条款，并且功能也可能有所不同。 在使用 Google Maps Platform 进行构建之前，请查看以下特定于 EEA 的 条款和信息：

如果您的账单邮寄地址不在 EEA，则以下服务条款适用于您：

Google 地图提供方信息要求

本部分提供了通过应用显示 Google 地图和内容时应遵循的提供方信息要求和指南。

显示 Google 地图提供方信息

在应用或网站中显示 Google Maps Platform API 中的内容时，您必须遵守 Google 地图提供方信息要求。如果内容显示在 Google 地图上，且提供方信息已可见，则无需添加额外的提供方信息。

包含的 Google 地图提供方信息

对于 Google Maps Platform 在 用户界面中已提供的 Google 地图提供方信息（例如 Places UI Kit 中的提供方信息），请注意以下事项：

  • 无论包含的提供方信息显示在何处，都不要移除。请勿更改、隐藏、 或遮盖提供方信息，并确保提供方信息在背景中清晰可见。
  • 始终使用界面 提示（例如边框、背景颜色、阴影或足够的空白）在视觉上将 Google Maps Platform 内容与其他内容区分开。
  • 进行视觉修改时，您必须遵守所有 Google 地图提供方信息 要求。

应尽可能使用 Google 地图徽标作为提供方信息。如果空间有限，则可以使用文字 Google 地图 。最终用户必须始终清楚哪些内容由 Google 地图提供。

左侧：Google 地图徽标提供方信息，右侧：Google 地图文字提供方信息
左图：Google 地图徽标提供方信息，右图：Google 地图文字提供方信息

徽标提供方信息

在应用或网站中使用 Google 地图徽标时，请遵循以下要求。
Google 地图徽标提供方信息的可接受变体
Google 地图徽标提供方信息的可接受变体

下载 Google 地图徽标

请使用官方 Google 地图徽标文件。下载下方的徽标，并遵循本部分中的指南。

下载 Google 地图提供方信息素材资源

使用 Google 地图徽标时，请遵循以下指南。

  • 请勿以任何方式修改徽标。
  • 保持徽标的宽高比，以防止变形。
  • 在杂乱的背景（例如地图或图片）上使用带轮廓的徽标。
  • 在纯色或细微渐变等纯色背景上使用不带轮廓的徽标。

徽标尺寸规范

请遵循以下 Google 地图徽标尺寸规范：
  • 徽标高度下限： 16dp
  • 徽标高度上限： 19dp
  • 徽标周围的最小空白区域： 左侧、右侧和顶部为 10dp，底部为 5dp

如需了解 dp，请参阅 Material Design 网站上的像素密度。

Google 地图徽标，显示了最小留白空间和可接受的尺寸范围
Google 地图徽标，显示了最小空白区域和可接受的尺寸范围

徽标无障碍功能

请遵循以下 Google 地图徽标无障碍功能要求：
Google 地图徽标提供方信息中不可接受的变体和无障碍功能问题
Google 地图徽标提供方信息不可接受的变体和无障碍功能问题

文字提供方信息

如果界面尺寸不支持使用 Google 地图徽标，您可以使用文字拼写出 Google 地图 。请遵循以下指南：

可接受的 Google 地图文字提供方信息变体
Google 地图文字提供方信息的可接受变体
  • 请勿以任何方式修改文字 Google 地图 ：
    • 请勿更改 Google 地图 的大小写
    • 请勿将 Google 地图 换行到多行
    • 请勿将 Google 地图 本地化为其他语言。
    • 使用 HTML 属性 translate="no" 阻止浏览器翻译 Google 地图 。
不接受的 Google 地图文字提供方信息变体
Google 地图文字提供方信息不可接受的变体

  • 请按照下表所述设置 Google 地图文字的样式：

    Google 地图文字样式要求
    属性 样式
    字体系列 Roboto。加载字体是可选操作。
    后备字体系列 产品中已使用的任何无衬线正文字体，或“Sans-Serif”以调用默认系统字体
    字体样式 正常
    字体粗细 400
    字体颜色 白色、黑色 (#1F1F1F) 或灰色 (#5E5E5E)。保持与背景的对比度符合无障碍功能要求 (4.5:1)。
    字号 字体大小下限：12sp
    字体大小上限：16sp
    如需了解 sp，请参阅 Material Design 网站上的字体大小单位。
    字间距 正常

示例 CSS

以下 CSS 代码段会在白色或浅色背景上以适当的排版样式和颜色呈现 Google 地图。

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

视觉要求

请遵循以下 Google 地图提供方信息视觉处理要求。

  • 将提供方信息放置在内容顶部或底部附近，并位于同一视觉容器内。对于单行内容，提供方信息可以放置在右侧或左侧。

  • 使用界面提示（例如边框、背景颜色、阴影或足够的空白）在视觉上将 Google Maps Platform 内容与其他内容区分开。

  • 请勿将 Google 地图与非 Google Maps Platform 内容混为一谈，以免误导用户。
  • 验证提供方信息是否始终可见且清晰易读。切勿移除、隐藏、遮盖或修改提供方信息。

下图展示了这些视觉要求的示例。

Google 地图提供方信息位于内容顶部、底部和侧面的示例
Google 地图提供方信息放置在内容顶部、底部和侧面的示例

区分 Google 地图内容（地点评分）与其他内容的三种方法示例
将 Google 地图内容（地点评分）与其他内容区分开的三种方法示例

请勿遮盖 Google 地图提供方信息，也不要将其与其他来源的内容混杂在一起
请勿遮盖 Google 地图提供方信息，也不要将其与其他来源的内容混在一起

第三方数据提供商

地图产品上的一些数据和图片来自 Google 以外的提供方。 对于某些产品（例如 Map Tiles API），我们可能会向您提供第三方数据提供商的必要提供方信息 。在这种情况下，提供方信息文字中必须提及“Google 地图”和相关数据提供方，例如“地图数据：Google、Maxar Technologies”。如果 Google 提供 第三方提供方信息，那么提供方信息中不应仅包含“Google 地图”或 Google 徽标。

其他提供方信息要求

以下提供方信息要求特定于 Places API。

最终用户地址自动补全

如果最终用户在客户应用中使用自动补全功能预先输入街道地址，并且该街道地址原本可以由该最终用户在不使用自动补全功能的情况下完整准确地提供，那么该最终用户选择的地址将不受 Google Maps Platform 协议中 Google 地图内容限制的约束。此例外情况仅适用于最终用户选择的街道地址，并且仅适用于 该最终用户的特定交易；它不适用于自动补全功能提供的建议地址列表 或其他 Google 地图内容。此例外情况不适用于其他 Google Maps Platform 服务提供的任何 POI 或地址查询功能。

自动补全最终用户地址

在上图中，左侧的地址列表仍受 Google 地图内容限制的约束。最终用户选择其选定的地址后，该地址将不受 Google 地图内容限制的约束，但仅限于该最终用户的 适用交易。

第三方提供方信息

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

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

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

响应的 Place 对象中的提供方信息由 Attribution 对象表示。若要将 Attribution 添加到响应中，请在请求的 字段掩码中添加 places.attributions（附近搜索和文本搜索）或 attributions （地点详情）。

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

显示照片的提供方信息

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

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

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

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

显示评价

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

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

显示作者信息

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

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

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

搜索结果提供方信息

在欧洲，使用 Google 的纯粹排名时，搜索产品必须提供说明文字，用户只需点击一下即可查看，说明文字应描述决定搜索结果排名的主要因素以及这些主要因素的权重。说明文字：

标题： 关于这些结果

正文： 当您搜索某个地点附近的商家或场所时，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) 进行举报。
查看评价 使用响应的 reviewSummary.reviewsUri 字段中包含的链接。
评价摘要披露声明
图 3：AI 赋能的评价摘要，其中显示了最终用户可通过溢出菜单访问的必要关联链接。

汽车用例的显示指南

为了驾驶员安全，Google 建议在汽车体验的停车模式下呈现 AI 赋能的摘要。如果在驾驶模式下呈现摘要，屏幕上的信息应简单、清晰、简洁，以确保驾驶员的注意力快速回到道路上：

  • 不超过 3 行
  • 不超过 120 个字符或 24 个字词
  • 字体大小下限为 24dp

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