地图图块 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 可不受缓存限制。地点 ID 会在 Map Tiles API 响应的 place_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 值。全景图片 ID 值在 Street View Static API 响应的 panoId 字段中返回。

仿真 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 启用归因功能

Cesium for Unity

如果您使用 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;