本文档介绍了自定义样式与浅色模式和深色模式之间的概念关系，并定义了不同的地图类型以及如何将样式应用于这些地图类型。
如需开始使用自定义样式，请参阅创建新样式。
了解浅色模式和深色模式
您可以为单个地图 ID 创建两种不同的样式：一种针对浅色背景进行了优化，另一种针对深色背景进行了优化。浅色背景地图使用的基本地图与深色背景地图不同。因此，您不能将一种样式用于两种模式。
浅色模式和深色模式样式可为不同的环境提供最合适的样式地图。在应用中使用地图 ID 时，您的应用可以根据编程行为或用户的设备设置加载相应的样式。
创建样式时选择浅色模式或深色模式
创建或复制样式时，您可以选择浅色模式或深色模式。创建样式后，您无法更改其模式。
您可以在样式详情页面 中查看样式类型。
如需了解创建自定义样式的分步说明，请参阅创建和使用地图 样式。
将一种浅色模式样式和一种深色模式样式与地图 ID 相关联
一个地图 ID 仅支持一种浅色模式样式和一种深色模式样式。当您 点击 修改 图标以更改 浅色模式样式或深色模式样式时，面板只会显示 该模式的样式。如需了解详情，请参阅将样式与地图 ID相关联。
了解如何将自定义样式应用于多种地图类型
Google Maps Platform 提供不同的地图类型来满足各种应用场景，包括 roadmap、terrain、2D hybrid、3D hybrid 和 navigation。自定义级别取决于地图是仅基于矢量数据（例如 roadmap 和 navigation）、使用矢量数据和光栅图像的组合（例如 2D hybrid 和 terrain），还是使用光栅图像、3D 多边形和矢量图像的组合（例如 3D hybrid）。
- 矢量数据地图
- “
roadmap”和“navigation”地图类型仅使用 矢量数据，这让您可以全面设置大多数地图项的样式，包括 陆地和水域的多边形、道路、地标和地图注点。
- 光栅图像地图
- “
terrain”、“2D hybrid”和“3D hybrid” 地图类型主要使用光栅图像，并在其上叠加矢量数据。因此，它们的样式设置功能有限。您通常只能设置叠加在图像上的 矢量数据的样式，例如标签、图钉和一些 多段线（即道路、边界）。您无法自定义属于基础图像的地图项，例如湖泊的颜色或山脉的外观。 - 例如，该图片显示了路线图，其中水域的自定义样式为粉色。 但是，当您预览地形图和混合地图类型的样式时，水域 不会显示为粉色。
地图类型定义和模式支持
下表定义了地图类型，并显示了哪些地图类型支持浅色模式和深色模式。
| 地图类型 | 说明 | 基本地图图像 | 模式支持 |
|---|---|---|---|
roadmap |
显示道路和主要地图项的标准地图视图。 | 矢量 | 共同主导 |
navigation |
一种专门针对使用 Navigation SDK 的逐向导航进行了优化的地图类型。如需详细了解导航，请参阅 Navigation SDK for Android 和 Navigation SDK for iOS的自定义地图样式概览。 | 矢量 | 共同主导 |
terrain |
一种强调山脉、河流和海拔等自然地形地图项的地图。 | 光栅 | 共同主导 |
2D hybrid |
卫星图像和路线图数据的组合，在图像上叠加显示街道名称和其他主要地图项。 | 光栅 | 仅浅色模式 |
3D hybrid |
一种逼真的 3D 地图，您可以在其中设置地图注点标签、道路和路标的可见性。此地图类型仅在 Maps JavaScript API 的 3D 地图中提供。 | 矢量和光栅 | 仅浅色模式 |
光栅图像地图的样式注意事项
设置 terrain、2D hybrid 和 3D hybrid 地图类型的样式时，您可能会看到以下行为：
在 Android 和 iOS 上使用
terrain地图类型时，您可能会注意到水域暂时闪烁。这是预期行为，因为在设置水域样式时，路线图图块会在地形图块之后加载。 这种延迟加载会导致自定义颜色出现短暂的视觉冲突。多边形样式可能会遮盖
terrain和2D hybrid地图类型中的底层地图元素。例如，地形图上的风格化公园多边形可能会隐藏细微的地形地图项。在 2D 混合地图上，它可能会隐藏底层卫星图像。对于
3D hybrid，道路多段线可能会在桥梁下方渲染，或者在立交桥和地下通道周围显示不正确。
在每种地图类型上预览样式
创建自定义样式后，请在不同的地图类型上对其进行测试，以了解它们的应用方式。这一点尤其重要，因为并非所有样式都适用于所有地图类型。
在 Google Cloud 控制台中，您可以在样式编辑器或地图详情页面中预览自定义样式，如下所示：
- 样式编辑器：在上下文面板中，选择
Map type下拉 列表并更改地图类型。地图会刷新并显示应用了样式的地图类型。 - 地图详情页面 ：在地图预览 部分中，您可以在浅色模式和深色模式样式之间切换，并在下拉列表中将变体更改为不同的地图类型。您必须先将样式与地图 ID 相关联，然后才能预览该样式。
将自定义样式应用于多种地图类型
在地图详情页面中，将浅色模式和深色模式样式与地图 ID 关联后，点击 显示更多 以选择是否将自定义样式应用于多种地图类型。您可以在地图预览 部分中再次查看样式在地图类型中的应用方式。