本文档列出了使用 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 的条款和信息:
- 《Google Maps Platform EEA 服务条款》
- Google Maps Platform EEA 服务专用条款
- 欧洲经济区常见问题解答 (FAQ)
- Google Maps Platform 道路安全要求
如果您的账单邮寄地址不在欧洲经济区,则您需遵守以下服务条款:
Google 地图出处标明要求
本部分提供了通过应用显示 Google 地图和内容时的提供方信息要求和准则。
显示 Google 地图提供方信息
在您的应用或网站中显示 Google Maps Platform API 中的内容时,您必须遵守 Google 地图提供方信息要求。如果内容显示在 Google 地图上,且提供方信息已显示在 Google 地图上,则无需添加额外的提供方信息。
包含 Google 地图提供方信息
对于 Google Maps Platform 已在界面中(例如在 Places UI Kit 中)提供的 Google 地图提供方信息:
- 无论包含的提供方信息显示在何处,都不要移除。请勿更改、隐藏或模糊处理提供方信息,并确保该信息在背景中清晰可见。
- 始终使用边框、背景颜色、阴影或足够的空白区域等界面提示,在视觉上将 Google Maps Platform 内容与其他内容区分开来。
- 进行视觉修改时,您必须遵守所有 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 地图本地化为其他语言。
- 使用 HTML 属性
translate="no"阻止浏览器翻译 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 以外的提供方。 对于某些产品(例如 Map Tiles API),我们可能会向您提供第三方数据提供商的必要提供方信息。如果使用此类图像,提供方信息文字中必须提及“Google 地图”和相关数据提供方,例如“地图数据:Google、Maxar Technologies”。如果 Google 提供第三方提供方信息,那么提供方信息中不应仅包含“Google 地图”或 Google 徽标。
其他 Places API 要求
以下要求仅适用于 Places API。
最终用户地址的自动补全功能
如果最终用户在客户应用中使用自动补全功能提前输入街道地址,并且该最终用户在未使用自动补全功能的情况下也能完全准确地提供该街道地址,那么该最终用户选择的地址不受《Google 地图平台协议》中 Google 地图内容限制的约束。 此例外情况仅适用于最终用户选择的街道地址,且仅适用于该最终用户的特定交易;不适用于自动补全功能提供的建议地址列表或其他 Google 地图内容。此例外情况不适用于其他 Google Maps Platform 服务提供的任何 POI 或地址查找功能。
左侧的地址列表仍受 Google 地图内容限制的约束。最终用户选择地址后,该地址将不再受 Google 地图内容限制的约束,但仅限于最终用户的适用交易。
照片和评价
将所有内容归因于内容作者
在展示照片或评价时,您必须始终注明作者。每张照片和每条评价都包含作者信息(作者的头像图片、姓名和个人资料链接)。
作者信息显示方面的视觉要求:
- 在空间允许的情况下,使用所有可用资源(头像、名称和个人资料链接)注明作者。
- 对于评价,如果空间有限,则最低要求是显示作者的头像。
- 对于照片,如果空间有限(例如在图库中或对于缩略图),可以省略作者署名,前提是用户能够访问包含完整作者署名的较大版本图片。
- 将作者信息放置在与作者照片或评价明确相关联的位置。
直接访问 Google 地图上的来源内容
对于每张照片和每条评价,最终用户必须始终能够使用提供的 googleMapsUri 在 Google 地图上查看相应的源照片或评价。
显示相对发布日期(推荐)*
使用提供的 relativePublishTimeDescription 显示照片和评价的相对发布日期(例如“2 天前”)可提高用户对内容的信任度。
启用内容报告功能(推荐)*
无论身在何处,您通过 Places API 提供的照片和评价均须遵守 Google 的内容和产品政策。您和您的最终用户可以使用每张照片和每条评价旁边的 flagContentUri 举报您认为依据 Google 政策或适用法律应该从 Google 服务移除的内容。或者,您也可以通过 Google 地图上内容的直接链接举报内容,其中也提供问题举报功能。
评价
说明评价的排序和过滤方式
提供清晰的通知,说明评价的排序和过滤方式,包括所应用的任何搜索条件。默认情况下,评价会按相关性排序。
显示评价者到访法国境内地点的月份和年份
在显示法国和法属领地内地点的评价时,Places API 会返回 visitDate(作者光顾该地点的月份和年份),该信息必须与评价内容一起显示。
在评价被翻译后通知最终用户(推荐)*
让最终用户了解评价是否已从原始语言翻译而来。您可以允许最终用户查看未翻译的原始文本 originalText。或者,他们也可以点击 Google 地图上提供原始未翻译文本的内容的直接链接。
评价和平均评分
告知最终用户 Google 如何验证评价(推荐)*
评价未经 Google 核实,但 Google 会检查有无虚假内容,一旦发现会将其移除。在显示评价和平均评分时,告知最终用户 Google 的评价政策。 详细了解 Google 地图用户生成内容政策。
AI 赋能的摘要
在应用中显示 AI 赋能的摘要(包括地点摘要、区域摘要和评价摘要)时,您必须执行以下操作:
- 显示以下定义的必需提供方信息、举报链接和参考链接。
- 最终用户必须能够阅读 Google 地图提供的完整摘要文本。
显示 AI 赋能的摘要披露文本
在显示任何类型的 AI 赋能摘要时,请务必在摘要下方紧邻的位置添加本地化披露声明文本(在响应正文的 disclosureText 字段中提供)。切勿修改或扩充 API 提供的披露声明文本。
地点和区域摘要的其他要求
| 文本 | 要求 |
|---|---|
| 关于此摘要 | 请访问以下链接,了解“Google 如何获取和使用本地商家信息中的信息”:https://support.google.com/local-listings/answer/9851099。 |
| 举报摘要 |
使用响应的 注意:无论身在何处,您通过 Places API(新)获取的 AI 赋能的摘要均须遵守 Google 的内容和产品政策。您必须通知最终用户,如果他们想举报根据适用法律应从 Google 服务中移除的内容,应使用提供的举报内容网址 ( |
审核摘要要求
应用中显示的评价摘要必须附有标题“评价摘要”。此外,您还必须使用以下文字和必需的链接:
| 文本 | 要求 |
|---|---|
| 关于此摘要 | 如需了解“Google 如何获取和使用本地商家信息中的信息”,请访问以下链接:https://support.google.com/local-listings/answer/9851099 |
| 举报摘要 |
使用响应的 注意:无论身在何处,您通过 Places API(新)获取的 AI 赋能的摘要均须遵守 Google 的内容和产品政策。您必须通知最终用户,如果他们想举报根据适用法律应从 Google 服务中移除的内容,应使用提供的举报内容网址 ( |
| 查看评价 | 使用响应的 reviewSummary.reviewsUri 字段中包含的链接。 |
汽车用例的显示指南
为了确保驾驶员安全,Google 建议在停车模式下呈现 AI 赋能的摘要,以提供汽车体验。如果在驾驶模式下呈现摘要,屏幕上的信息应清晰简洁,以确保驾驶员的注意力快速回到道路上:
- 不超过 3 行
- 不得超过 120 个字符或 24 个字词
- 正面大小下限为 24dp
尤其是在汽车环境中,开发者有责任以安全且符合所有当地法律法规的方式呈现 AI 赋能的摘要。
地点搜索结果
说明影响搜索结果排名的因素(建议)*
在一次用户互动中,应让最终用户了解决定搜索结果排名的主要因素以及这些主要因素的权重。
如果使用 Google 的未修改排名,您可以显示以下说明文字:
“当您搜索某个地点附近的商家或场所时,Google 地图会显示本地搜索结果。并且会结合多种因素(主要是相关性、距离和知名度)帮助您找到最符合搜索条件的结果。了解详情。”
遵守适用法律
您必须始终遵守所有适用法律。请注意,这些政策中标记为(推荐)的做法可能仍受法律强制要求。此外,即使遵循所有明确的要求和推荐的做法,也无法保证在所有司法管辖区内完全符合法律规定。如果您对自己的合规状态有疑问,应咨询自己的法律顾问。