地图图块 API 政策

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

政策

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

预取、缓存或存储内容

如果应用是使用 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 协议文档实现该标头。

打印

如街景政策中所述,街景图像不得用于打印目的。

欧洲经济区国家和地区

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

如果您的账单邮寄地址不在欧洲经济区,则您需遵守以下服务条款:

显示 Google 地图和 Google 数据提供方信息的渲染图片
使用 Map Tiles API 应用于地图的 Google 地图提供方信息

在应用或网站中显示来自 Google Maps Platform API 的内容时,您必须添加清晰的 Google 地图提供方说明。提供方说明应尽可能采用 Google 地图徽标的形式。在空间有限的情况下,可以使用文本 Google 地图。

徽标归因

Google 地图徽标署名的可接受变体
Google 地图徽标署名的可接受变体

Google 地图徽标

请使用下方提供的官方 Google 地图徽标。

下载 Google 地图注明出处素材资源

使用 Google 地图徽标时,请遵循以下准则。

  • 请勿以任何方式修改徽标。
  • 保持徽标的宽高比,以免变形。
  • 在杂乱的背景(例如地图或图片)上使用带边框的徽标。
  • 在纯色或细微渐变等纯色背景上使用无轮廓徽标。

徽标尺寸规范

请遵循以下 Google 地图徽标尺寸规范:

  • 徽标高度下限:16dp
  • 徽标高度上限:19dp
  • 徽标留白空间下限:左侧、右侧和顶部为 10dp,底部为 5dp

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

Google 地图徽标,显示最小留白空间和可接受的尺寸范围
Google 地图徽标的表示形式,显示了最小留白和可接受的尺寸范围

徽标无障碍功能

请遵循以下有关 Google 地图徽标的无障碍要求:

  • 在徽标和背景之间保持无障碍对比度。
  • 添加一个包含文本 Google 地图的无障碍标签。

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

当您使用 Map Tiles API 通过第三方渲染程序显示 Google 地图时,不得使用任何其他徽标(例如渲染程序的徽标)重叠或遮挡 Google 徽标。在 Google 徽标和第三方徽标之间保持合理的缓冲距离,使它们看起来像是独立的徽标。任何徽标都不得与 API 响应提供的数据属性重叠或遮挡。

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

显示 Google 的数据提供方信息

从 Map Tiles API 返回的数据需要显示来自相应元数据或视口信息请求的作者信息和版权信息。您应在适当的位置(通常是所显示图块集的右下角或 3D 渲染器视图中)完整显示此信息。请注意,提供方说明字符串是可变的,具体取决于渲染程序视口请求的地图数据。

如果由于视口大小限制而无法完整显示数据属性,请考虑添加一个标有“数据源”的悬停或可点击界面元素,该元素会在地图窗口中打开,以提供属性信息。始终以保持良好的制图实践为目标。

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

显示第三方数据提供方

地图产品上的一些数据和图片来自 Google 以外的提供方。 对于某些产品(例如 Map Tiles API),我们可能会向您提供第三方数据提供商所需的提供方说明。如果使用此类图像,提供方信息文字中必须提及“Google 地图”和相关数据提供方,例如“地图数据:Google、Maxar Technologies”。如果 Google 提供了第三方提供方信息,那么提供方信息中不应仅包含“Google 地图”或 Google 徽标。

当您使用 Map Tiles API 将 Google 地图数据作为基本地图显示并叠加第三方(非 Google)地理空间数据时,不得以任何方式将 Google 数据提供方信息与第三方数据提供方信息重叠或遮挡。第三方数据的归属必须与 Google 的数据归属明确区分开。此外,必须明确 Google 地图徽标和 Google 的数据提供方信息与底图相关联,并且彼此相关联。

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

如果您在叠加自己的地图数据时使用 Google 地图数据作为基本地图,则必须确保您的受众群体完全了解地图可视化效果的哪些部分归因于 Google,哪些部分归因于您自己的地图数据。此外,请遵循上文显示 Google 地图提供方信息中的指南。

例如,您可以考虑将仿真 3D 图块(作为背景填充)与您自己的仿真模型(位于前景中)结合使用。用户可能会对场景中的哪些组件源自 Google 地图数据感到困惑。在这种情况下,您必须在界面提供方说明字符串或用户体验流程中明确说明场景的哪些部分源自 Google 地图数据。您有责任遵守可能适用于您与 Google 地图数据一起使用的数据源的任何第三方标明出处要求。

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

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

使用 Map Tiles API 制作视频

  • 宣传视频:您可以根据本协议的条款和以下规定制作宣传视频:
    • 宣传视频不得包含街景图像。
    • 宣传视频的时长不得超过 30 秒。
    • 宣传视频必须介绍应用的功能。
    • 宣传视频必须清楚地标明“仅用于宣传目的”,并且必须遵守显示 Google 地图注明出处准则。
    • 推荐视频不得单独转售,也不得作为软件、应用或用户体验的一部分转售。
  • 移除:您有责任遵守所有移除宣传视频的要求,包括来自第三方的要求。

根据您使用的服务,从以下 API 调用的响应中的 copyright 字段获取提供方和版权信息:

2D 图块

路线图、卫星和地形图块

视口信息响应中提供了版权和提供方信息,如以下示例所示。

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

街景图块

版权和归因信息可从街景元数据响应中获取。例如:

{
 "panoId": "rZ9KeTyhA11i0VppYNzsSg",
 "lat": 37.420864219339165,
 "lng": -122.08446528377291,
 "imageHeight": 6656,
 "imageWidth": 13312,
 "tileHeight": 512,
 "tileWidth": 512,
 "heading": 94.35,
 "tilt": 88.39652,
 "roll": 1.7181772,
 "imageryType": "outdoor",
 "date": "2023-01",
 "copyright": "© 2023 Google",
 "reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0",
  …
}

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

您必须在图片的右下角显示 reportProblemLink 超链接,并且该超链接必须包含链接文字,例如“报告此图片存在的问题”。

仿真 3D 图块

对于仿真 3D 图块,系统会在每个图块请求中返回提供方信息数据。 您必须将所显示图块的所有提供方信息汇总、排序并显示在一行中,通常位于渲染图的底部。例如,您可以在 glTF 3D 图像块中查找 asset、copyright 下的数据属性。

{
  "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 启用提供方信息