Geocoding API 的政策和提供方信息

本文档列出了使用 Geocoding API 开发的应用的要求。请注意，使用 Geocoding API 时，须遵守您与 Google 签订的协议。

政策

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

缓存限制的例外情况

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

客户端过滤和重新排序

您可以对顶级结果列表执行客户端过滤，例如移除不符合特定国家/地区或邮政编码条件的地址结果。您还可以过滤或重新排列单个结果中包含的子列表，例如优先显示某些导航点，只要过滤或重新排列条件不会误导最终用户即可。您必须确保这些修改不会歪曲 API 返回的原始数据。

欧洲经济区国家和地区

对于账单邮寄地址位于欧洲经济区 (EEA) 的客户，此产品有不同的服务条款，并且可能还具有不同的功能。 在使用 Google Maps Platform 进行构建之前，请查看以下 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 地图换行
    • 请勿将 Google 地图 本地化为其他语言。
    • 使用 HTML 属性 translate="no" 阻止浏览器翻译 Google 地图。
Google 地图文字属性的不当变体
Google 地图文本出处注明的不当变体示例

  • 按照下表中的说明设置 Google 地图文本的样式：

    Google 地图文本样式要求
    属性 样式
    字体系列 Roboto。加载字体是可选操作。
    后备字体系列 产品中已使用的任何 Sans Serif 正文字体，或用于调用默认系统字体的“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 徽标。

AI 赋能的摘要（目的地）

在应用中显示 SearchDestinations 方法返回的 AI 赋能的摘要时，您必须执行以下操作：

  • 按照本部分中的定义，显示必要的提供方说明、报告链接和参考链接。
  • 确保最终用户可以阅读 Google Maps Platform 提供的完整摘要文本。

显示 AI 赋能的摘要披露文本

显示 AI 赋能的摘要时，请务必在摘要正下方添加 disclosureText 响应字段中提供的已本地化披露声明文本。切勿修改或扩充 API 提供的披露文本。

AI 赋能的摘要，附带披露文本
图 1：AI 赋能的摘要下方正确显示的披露声明文本。

到达摘要要求

应用中显示的到站摘要必须附带以下文字和必需的链接：

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

使用响应的 flagContentUrl 字段中包含的链接，向 Google 报告摘要内容存在的问题。

注意：无论您身在何处，通过 Geocoding API 提供的 AI 赋能摘要均须遵守 Google 的内容和产品政策。您必须告知最终用户，如果他们希望根据适用法律举报应从 Google 服务中移除的内容，则应使用提供的举报内容网址 flagContentUrl 进行举报。
AI 赋能的摘要，其中包含必需的链接
图 2：AI 赋能的摘要，其中包含通过溢出菜单向最终用户提供的必需关联链接。

汽车用例的显示指南

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

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

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