使用嵌入式 JSON 样式声明

请选择平台： Android iOS JavaScript

您可以通过嵌入式 JSON 样式声明将自定义样式设置应用于以下各项：

• 默认地图。
• 用户可在单个地图框架内切换的地图类型。

如果您想更新多个应用中的同一样式，请了解 Google Cloud 控制台中的云端地图样式设置，该功能需要地图 ID。 为避免潜在的冲突，请勿在同一应用中同时使用云端地图样式设置和硬编码的样式设置。

如需获得更全面的样式设置体验，您可以改用基于 JSON 的样式设置和云端地图样式设置， 这两种方式可提供更广泛的地图功能和更丰富的自定义选项。云端地图样式设置 JSON 架构不向后兼容嵌入式 JSON 样式声明。这意味着，云端地图样式设置 JSON 无法直接在 Maps JavaScript API 中使用。不过，您可以将嵌入式 JSON 样式声明导入到云端地图样式设置 JSON 架构中。

为地图项指定样式

若要向地图中不同的地图项和元素应用样式，请创建一个 MapTypeStyle 对象数组，用于定义应如何设置地图样式。

该数组采用以下形式：

var stylesArray = [
  {
    featureType: '',
    elementType: '',
    stylers: [
      {color: ''},
      {visibility: ''},
      // Add any stylers you need.
    ]
  },
  {
    featureType: '',
    // Add the stylers you need.
  }
]

如需查看 featureType、elementType 和 stylers 的所有可用值的列表，请参阅 JSON 样式参考。

Maps Platform 样式设置向导

为 Google Maps Platform API 创建自定义样式

使用 Maps Platform 样式设置向导可以快速生成 JSON 样式设置对象。

注意 ：如需将样式应用于多个应用平台，请考虑使用云端地图样式设置。如果您想使用 JSON 样式，可以将其导入。如需了解详情，请参阅导入 JSON 地图样式。

将样式应用到默认地图

下例展示了一个在深色背景（即深色模式）下使用浅色文本和图标来设置样式的默认地图。如需查看代码示例，请前往自定样式的地图 - 夜间模式代码示例。

若要修改默认地图的样式，请在以下情况下将 MapOptions 对象中地图的 styles 属性设置为您的样式数组：

• 创建地图时。
• 或者，调用 Map.setOptions 方法时。

更改标签和道路会影响所有地图类型，包括地形、卫星、混合和默认路线图类型。

将样式应用到地图类型

下图展示了一个名为自定样式的地图的新增地图类型（位于地图左上角的控件中）。如需查看代码示例，请前往自定样式的地图类型。

若要创建自定样式的地图类型，请将样式数组设置为 StyledMapType 对象。创建新的自定样式的地图类型不会影响默认地图类型的样式。