使用嵌入式 JSON 样式声明

请选择平台： Android iOS JavaScript

您可以通过嵌入式 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 样式设置对象。

将样式应用到默认地图

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

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

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

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

将样式应用到地图类型

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

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