本文档列出了使用 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 指南。
显示 Google 徽标
当您使用 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 的数据提供方说明
若要从 Map Tiles API 返回数据,您需要显示来自相应元数据或视口信息请求的提供方说明和版权信息。您应在适当的位置(通常是所显示图块集的右下角)或 3D 渲染程序视图中完整显示这些信息。请注意,提供方说明字符串是可变的,具体取决于渲染程序的视口请求的地图数据。
如果因视口尺寸限制而无法完整显示数据提供方说明,不妨考虑添加标记为“数据源”的悬停或可点击界面元素,它会在地图窗口中打开以提供归因信息。始终以保持良好的制图做法为目标。
显示第三方数据提供方说明
当您使用 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 政策中的提供方说明指南。
- 宣传视频不得单独转售,也不得作为软件、应用或用户体验的一部分转售。
- 移除:您有责任遵守所有移除宣传视频的要求,包括第三方提出的移除要求。
检索提供方和版权信息
根据您使用的服务,从以下 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,
}));
Unreal 版 Cesium
如果您使用 Cesium for Unreal 作为渲染程序,如需显示归因,您需要在 World Outliner 中启用 Show Credits On Screen。
Unity 版 Cesium
如果您使用适用于 Unity 的 Cesium 渲染程序,为了显示归因,您需要在检查器控制台中启用 Show Credits On Screen 字段。
Google 归因的样式指南
如果您无法使用可下载的 Google 徽标,请遵循 CSS 和 HTML 中 Google 提供方说明的样式指南。
留白
完整标识周围的留白空间应等于或大于 Google 中“G”的高度。
提供方说明与 Google 徽标之间的间距应为“G”宽度的一半。
易读性
署名应始终清晰可辨,并且根据给定背景以正确的颜色变化显示。请务必为您选择的徽标变体提供足够的对比度。
颜色
在白色或浅色背景上使用 Google Material 灰色 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;