使用嵌入式 JSON 样式声明

请选择平台： Android iOS JavaScript

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

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

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

为地图项指定样式

若要向地图中不同的地图项和元素应用样式，请创建一个 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 样式设置对象。

向默认地图应用样式

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

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

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

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

将样式应用到地图类型

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

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