设置缩放级别样式

请选择平台： Android Android 3D iOS iOS 3D JavaScript Web 服务

适用范围：此功能在 Android、iOS、JavaScript 和 Maps Static 中提供。

您可以在用户查看地图时所用的缩放级别下突出显示地图项，提供更符合用户需求的地图体验。例如，您可以在用户放大查看特定位置时，突出显示相关地图注点或道路。

您可以为地图项元素设置样式，使其在地图的所有缩放级别都显示相同的效果；对于某些元素，您可以针对不同的缩放级别创建不同的样式。

并非所有地图项都支持自定义缩放级别。如果相应地图项元素支持设置缩放级别样式，右侧会显示一个菱形图标。

了解缩放级别样式

缩放级别的范围为 0 到 22，0 表示缩小到最低级别（显示整个世界），22 表示放大到最高级别（详细显示地图上的一小部分）。Keyzoom 是您希望开始应用新样式的起始缩放级别。

当您为地图项设置不同缩放级别的样式时，相应样式将应用于所有更高的缩放级别（放得更大的级别），直至遇到另一个缩放级别样式。系统总是会为缩放级别 0 添加当前样式。

例如，如果您针对缩放级别 5 和 10 设置样式：

• 缩放级别 5 的样式将应用于缩放级别 5-9。
• 缩放级别 10 的样式将应用于缩放级别 10-22。
• 缩放级别 0-4 则保留当前样式。

如果您为地图项自定义缩放级别样式，该样式会覆盖整个地图项的所有自定义样式。

注意：只有很少的地图项会在所有缩放级别都显示。您定义的样式仅会应用于用户可看到相应地图项的缩放级别。

了解 3D 地图的缩放级别转换

当您倾斜 3D 地图并在缩放级别之间切换时，您可能会看到超出所设缩放级别样式的过渡颜色。

例如，如果您按如下方式设置缩放级别样式：

• 对于缩放级别 10，水域填充颜色 = 黑色。
• 对于缩放级别 11，水域填充颜色 = 白色。

在两个缩放级别之间转换时，水体填充颜色可能会显示为灰色，如下图所示：

自定义不同的缩放级别

1. 在 Cloud 控制台中，前往地图样式页面，然后根据需要选择项目。

2. 创建或打开一个地图样式，然后选择自定义。 如需了解详情，请参阅创建地图样式。

3. 在地图项面板中，选择要自定义的地图项。系统会打开样式面板，显示支持自定义的元素。

4. 在要添加缩放级别样式的元素旁边，选择右侧的缩放菱形图标，打开 keyzoom 面板。

   

5. 在当前缩放级别旁边，选择要自定义的缩放级别。预览地图即会调整到该缩放级别。

   

   注意： 如果地图项尚未自定义，则关键缩放级别面板会显示其各自关键缩放级别的所有可用默认底图颜色值。

6. 选择添加 Keyzoom，在所选缩放级别添加新的 keyzoom，并显示相应的默认底图值。

   

7. 根据需要设置此缩放级别和任何其他缩放级别的样式。

   

   注意：缩放级别样式会应用于所选缩放级别及更高（放得更大）的级别。因此，在本例中，针对缩放级别 12 至 22，填充颜色为黑色（为相应元素设置的当前样式）；针对缩放级别 0（显示整个世界）至 9，填充颜色为蓝色；针对缩放级别 10 至 11，填充颜色为浅蓝色。

8. 若要设置其他缩放级别的样式，请更改当前缩放级别，然后再次选择添加 Keyzoom，在列表中添加其他缩放级别。继续添加和设置缩放级别样式，直至完成。

9. 完成后，关闭 keyzoom 面板。

覆盖元素的默认底图颜色值

如需在所有缩放级别覆盖某个元素的所有默认基本地图颜色值，请先为该元素设置样式。添加关键缩放级别后，关键缩放级别会使用您为元素设置的颜色，而不是默认底图颜色。

保存并发布缩放级别样式

1. 若要保存地图样式更改，请选择保存。

2. 若要将更改应用到与地图样式关联的地图 ID，请选择发布。

移除缩放级别样式

1. 在地图项面板中，选择自定义的地图项。

2. 在样式元素旁边，选择右侧的菱形图标。 具有自定义缩放级别样式的元素会显示一个蓝色的实心菱形图标。

   

3. 在 keyzoom 面板中，选择减号图标即可删除缩放级别。

   

移除所有缩放级别样式

如果您要移除地图项元素的所有自定义样式，可以执行以下任一操作：

• 在样式面板中，选择元素名称旁边的 减号图标。
• 在keyzoom 面板中，选择元素名称旁边的 重置图标。

预览道路级详情

您可以在现有样式中预览缩放级别 17+ 的增强型道路级细节，例如部分城市中的真实道路宽度、人行道、车道标记和其他地图项。您必须为每个样式编辑器会话启用预览。这些道路详情地图地图项仅在支持道路级详情的 SDK 或 API 中可见。如需在应用中应用这些样式，您必须将关联的 SDK 或 API 更新到支持道路级详情的版本。如需详细了解 API 和 SDK 版本，请参阅 Google Maps Platform 的道路级详情。

如需启用道路详情预览，请执行以下操作：

1. 在 Google Cloud 控制台中，前往地图样式。

2. 选择现有样式或创建样式。

3. 点击自定义。

4. 在样式编辑器中，点击道路详情预览。

5. 在预览对话框中，将道路详情切换为开启。

如需详细了解您可以设置哪些道路级别详情的样式，请参阅您可以在地图上设置哪些元素的样式。

添加缩放级别样式，以使缩放级别 17+ 的样式过渡更柔和

在缩放级别 17+ 且启用了道路级别详情的情况下，道路地图项会消失，并变为路面地图项。放大后，适用于“Surface”地图项的所有样式化元素都会显示，并替换“Road”地图项和样式。

为了使地图项样式之间的过渡更加平滑，您可以添加缩放级别样式，以在特定缩放级别之间锁定样式颜色。您还可以使用缩放级别样式来控制何时平滑过渡到新的样式颜色。

例如，在缩放级别 16 下，列出的地图项样式如下：

• 主干道为红色。
• 高速公路为蓝色。
• 本地为黄色。
• 表面为米色。

当您放大到缩放级别 17 时，干道、高速公路和本地道路会更改为“地面”地图项，其样式为米色。

为了在道路地图项和地表地图项之间实现更平滑的过渡，请添加以下关键缩放级别和缩放级别样式：

地图项	缩放级别 0	缩放级别 12	缩放级别 17
动脉	红色	红色	米黄色
高速公路	蓝色	蓝色	米黄色
局部	黄色	黄色	米黄色

添加缩放级别样式后，当您放大时，会发生以下情况：

• 在缩放级别 0 到 12，主干道、高速公路和本地道路会显示自定义样式颜色。
• 缩放级别超过 12 后，样式颜色开始逐渐变为米色，直到缩放级别达到 17 时，完全过渡到“地表”地图项样式的米色。

注意 ：光栅不支持此功能插值，因此您只能为移动应用或使用 JavaScript 矢量地图的应用平滑样式转换。