本文档列出了使用 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
标头,该标头还应
使用
重新验证。
请注意,用于唯一标识地点的地点 ID 可不受缓存限制。系统会在 Map Tiles API 响应。如需了解如何保存、刷新和管理地点 ID,请参阅地点 ID 指南。
显示 Google 徽标
使用 Map Tiles API 显示 Google 地图时,您还必须 在地图上显示 Google 徽标,您不得以任何方式更改该徽标。 您应将 Google 徽标放置在地图的左下角,并且 您应将提供方说明信息放在地图的右上角 ,了解所有最新动态。如需更多信息,请查看我们的 <ph type="x-smartling-placeholder"></ph> 品牌资源中心指南。
想要获得更具电影感的 3D 地图体验,也就是说, 体验式用户体验设计要求无法轻易地适应这些展示位置 您仍应清晰地显示 Google 徽标,或 体验的结束或两端,使得地图的作者 理解您的受众群体所理解的内容您仍需遵守 第三方数据出处(如下所述) 如电影般的体验请参阅显示徽标和 混合可视化图表中的数据归因,获取更多指导。
以下地图示例显示了地图左下角的 Google 徽标, 和右下角的提供方说明。
用于浅色背景 | 用于深色背景 |
---|---|
![]() |
![]() |
以下 zip 文件包含不同大小的 Google 徽标,分别适用于桌面设备、 Android 和 iOS 应用。您不得以任何方式修改这些徽标或调整其尺寸。
请勿修改提供方信息。请勿移除、裁剪掉提供方信息,或对其进行模糊处理。您不能内嵌使用 Google 徽标(例如,“这些地图来自 [Google_logo]”)。
确保提供方信息靠近内容。如果不是以直接嵌入方式使用 Google 图像屏幕截图,那么显示的标准提供方信息应与图片中的内容相同。如有必要,您可以自定义提供方信息文字的样式和位置,只需确保文字紧邻内容且清晰可辨,能够让普通观众或读者轻松阅读。您不得将提供方信息移到内容区域之外的位置,例如放在图书末尾、文件或节目的人员名单或网站的页脚中。
注明第三方数据提供方。地图产品上的一些数据和图片来自 Google 以外的提供方。如果使用此类图像,提供方信息文字中必须提及“Google”和相关数据提供方,例如“地图数据:Google、Maxar Technologies”。如果图像中提及第三方数据提供方,那么提供方信息中不应仅包含“Google”或 Google 徽标。
如果要使用 Google Maps Platform 的设备实际无法显示提供方信息,请与 Google 销售团队联系,了解您的使用情形适用的许可。
通过第三方渲染程序显示 Google 徽标
当您通过 Map Tiles API 使用 您不得将 Google 徽标与 其他徽标,例如渲染程序的徽标。保持合理的缓冲距离 Google 徽标与第三方徽标之间, 独立徽标。任何徽标不得与提供的数据提供方发生重叠或遮挡 。
显示 Google 的数据出处
从 Map Tiles API 返回的数据需要显示提供方说明 来自相应元数据或视口信息的版权信息 请求。您应该按照 通常位于所显示地图组的右下角 还是在 3D 渲染程序视图中请注意,提供方说明字符串包括 变量,具体取决于渲染程序的视口请求的地图数据。
如果因视口大小而无法完整显示数据提供方 那么您可以考虑添加标记为“Data 来源”,它在地图窗口中打开,用于提供出处信息。 始终以维护良好的制图效果为目标 做法。
显示第三方数据出处
当您使用 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 秒。
- 宣传视频必须介绍您的 。
- 宣传视频必须清楚地标明“用于宣传目的 ”并且必须遵守归因指南 Map Tiles 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 值,
。街景的 panoId
字段中返回全景图片 ID 值
查看静态 API 响应。
仿真 3D 图块
对于仿真 3D 图块,每个图块请求中都返回归因数据。
您必须汇总、排序并在同一行中显示所有提供方说明
tiles;通常在渲染底部显示例如,您可以找到
glTF 中的数据提供方说明
查看
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,
}));
适用于 Unreal 的 Cesium
如果您使用适用于 Unreal 的 Cesium 作为渲染程序, 您需要启用 Show Credits On Screen 字段(在 世界大纲。
适用于 Unity 的 Cesium
如果您使用 Cesium for Unity 作为渲染程序, 您需要启用 Show Credits On Screen 字段(在 检查器控制台。
Google 提供方信息样式指南
如果无法使用可下载的 Google 徽标,请按照以下样式指南使用 CSS 和 HTML 添加 Google 提供方信息。
留白空间
完整标识周围的留白空间应等同或超过 Google 中“G”的高度。
提供方信息和 Google 徽标之间的间距应为“G”宽度的一半。
![](https://developers.google.cn/static/maps/images/policies_spacing.png?authuser=7&hl=el)
易读性
署名应始终清晰可辨,而且颜色应适合给定背景。务必要为所选择的徽标变体提供足够的对比度。
颜色
如果是白色或浅色背景,文字应使用 Google Material Gray 700,黑色色调最高介于 0% 到 40% 之间。
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
如果是深色背景,而且是摄影作品或简单图案,应使用白色文字标注署名和提供方信息。
#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;