地图图块 API 政策

本文档列出了使用 Map Tiles API 开发的应用应满足的要求。请注意，使用 Map Tiles API 受您与 Google 签订的协议约束。

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

如果您开发 Map Tiles API 应用，则必须随应用一起提供使用条款和隐私权政策，以满足您与 Google 达成的协议中概述的准则：

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

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

移动应用

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

Web 应用

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

预取、缓存或存储内容

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

具体而言，应用应使用 Map Tiles API 进行地图可视化。您不得将 Map Tiles API 用于任何非可视化用例，例如：

  • 图像分析
  • 机器解释
  • 对象检测/识别
  • 提取或转售地理数据
  • 离线使用，包括用于上述任何用途

Map Tiles API 响应可能包含 Cache-Control 标头，应根据 HTTP 协议文档进行实现。例如，当响应中传递 max-age 值、stale-while-revalidate 值、must-revalidate 指令和 private 指令时，您的客户端必须遵循这些值。

Map Tiles API 响应可能还包含 ETag 标头，在进行带重新验证的请求时，也应根据 HTTP 协议文档实现该标头。

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

使用 Map Tiles API 显示 Google 地图时，您还必须在地图上显示 Google 徽标，并且不得以任何方式更改该徽标。您应将 Google 徽标放置在地图的左下角，并将提供方说明信息放置在地图的右下角。如需了解详情，请参阅我们的 品牌资源中心指南。

对于更具电影效果的 3D 地图体验（即，如果您的体验式用户体验设计要求无法轻松满足这些展示位置准则），您仍应在体验的开头、结尾或两者都显示 Google 徽标，以便观众了解地图的作者。在整个电影体验的整个过程中，您仍需要遵守显示第三方数据提供方说明的相关要求。如需更多指导，请参阅下面的在混合可视化图表中显示徽标和数据提供方说明。

在下面的地图示例中，Google 徽标显示在地图左下角，提供方说明显示在右下角。

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

下载：google_logo.zip

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

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

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

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

使用第三方渲染程序显示 Google 徽标

当您使用 Map Tiles API 通过第三方渲染程序显示 Google 地图时，不得将 Google 徽标与任何其他徽标（例如渲染程序的徽标）重叠或遮挡。请在 Google 徽标和第三方徽标之间保持合理的缓冲距离，以便它们显示为独立的徽标。任何徽标都不得重叠或遮盖 API 响应提供的数据提供方说明。

显示 Google 和 Cesium 徽标的渲染图片

显示 Google 的数据出处

Map Tiles API 返回的数据需要显示相应元数据或视口信息请求中的提供方说明和版权信息。您应在适当的位置（通常是显示的一组功能块的右下角）或 3D 渲染程序视图中，完整显示此信息。请注意，提供方说明字符串是可变的，具体取决于渲染程序视口请求的地图数据。

如果因视口大小限制而无法完整显示数据归因，不妨考虑添加标记为“数据源”的悬停或可点击的界面元素，该元素会在地图窗口中打开以提供归因信息。始终以良好的地图绘制做法为目标。

包含 Google 徽标和数据提供方提供方信息的页脚。

显示第三方数据提供方说明

当您使用 Map Tiles API 将 Google 地图数据显示为基本地图并叠加第三方（非 Google）地理空间数据时，您可能需要显示来自第三方数据提供商的提供方说明。您不得以任何方式使 Google 数据归因与第三方数据归因重叠或不清晰。第三方数据的归因必须明确与 Google 的数据归因分开。此外，您必须明确说明 Google 的徽标和 Google 的数据提供方信息与基本地图相关联，并且彼此关联。

在混合可视化图表中显示徽标和数据提供方说明

如果您在将 Google 地图数据用作基本地图的同时叠加自己的地图数据，则必须确保受众群体充分了解地图可视化的哪一部分出自 Google，哪些部分出自您自己的地图数据。此外，还应遵循上述显示 Google 徽标中的准则。

例如，不妨考虑将 Photorealistic 3D 功能块（作为背景填充项）与您自己的 Photorealistic 模型（在前景中）相结合。用户可能会感到困惑，不知道场景的哪些组成部分来自 Google 地图数据。在这种情况下，您必须在界面提供方说明字符串或用户体验流程中明确说明场景的哪一部分来自 Google 地图数据。您有责任遵守可能适用于您与 Google 地图数据搭配使用的任何第三方提供方说明要求。

使用仿真 3D 图块的地理数据叠加层

您可以将自己的 3D 对象叠加在仿真 3D 图块上，前提是这些 3D 对象不是手动或通过机器从仿真 3D 图块中提取、描绘或以其他方式派生的。

使用 Map Tiles API 制作视频

  • 宣传视频：您可以制作宣传视频，但须遵守本协议的条款以及以下规定：
    • 宣传视频不得包含街景图像。
    • 宣传视频时长不得超过 30 秒。
    • 宣传视频必须介绍应用的功能。
    • 宣传视频必须明确标注“仅用于宣传目的”，并且必须遵守 Map Tiles API 合作规范中的归因准则。
    • 不得单独或作为软件、应用或用户体验的一部分转售宣传视频。
  • 移除：您有责任遵循所有关于移除宣传视频的要求，包括第三方提出的要求。

从以下 API 调用的响应中的 copyright 字段获取归属和版权信息，具体取决于您使用的服务：

2D 图块

路线图、卫星和地形图块

版权和提供方信息可从视口信息响应中获取，如以下示例所示。

{
  "copyright": "Map data ©2023",
  "maxZoomRects": [
    {
      "maxZoom": 19,
      "north": 90,
      "south": -90,
      "east": 180,
      "west": -180
    },
    ...
  ]
}

街景图块

您可以从街景元数据响应中获取版权和归属信息。例如：

{
  "panoId": "Zzl28rqGJgaL2IdkUleP8A",
  "lat": 50.059138596550696,
  "imageHeight": 6656,
  "imageWidth": 13312,
  "tileHeight": 512,
  "tileWidth": 512,
  "copyright": "From the Owner, Photo by: Google",
  …
}

用于唯一标识街景全景图片的全景图片 ID 不受缓存限制。因此，您可以无限期地存储全景图片 ID 值。系统会在 Street View Static API 响应的 panoId 字段中返回全景图片 ID 值。

仿真 3D 图块

对于仿真 3D 图块，每个图块请求中都返回归因数据。您必须汇总、排序并一行显示所显示图块的所有属性；通常在渲染的底部。例如，您可以通过查看 asset 和 copyright 在 glTF 功能块中找到数据提供方说明。

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

CesiumJS

如果您使用 CesiumJS 作为渲染程序，则需要在渲染 HTML 中启用 showCreditsOnScreen 才能显示提供方信息。

// Add Photorealistic 3D Tiles tileset.
    const tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
      url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",
      // This property is needed to appropriately display attributions
      // as required.
      showCreditsOnScreen: true,
    }));

Cesium for Unreal

如果您使用的是 Cesium for Unreal 作为渲染程序，则如需显示提供方信息，您需要在世界轮廓工具中启用在屏幕上显示制作人员名单字段。

如何为 Cesium for Unreal 启用归因功能

适用于 Unity 的 Cesium

如果您使用 Cesium for Unity 作为渲染程序，则需要在 Inspector 控制台中启用 Show Credits On Screen 字段，才能显示提供方信息。

如何为 Cesium for Unity 启用归因

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;