Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

云端地图样式设置的 JSON 参考

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

借助云端地图样式设置的 JSON 架构，您可以使用 JSON 自定义地图，就像通过样式编辑器界面自定义地图一样。本文档介绍了 JSON 架构以及如何进行 JSON 样式声明。

如需了解如何在样式编辑器中使用 JSON 编辑地图样式，或如何导入和导出地图样式，请参阅将 JSON 与云端地图样式设置搭配使用。

查看 JSON 样式声明示例

以下 JSON 样式声明设置了背景颜色，然后定义了地图注点、公园和水体的样式，并隐藏了餐饮场所的标签。


{
  "variant": "light",
  "styles": [
    {
      "id": "natural.land",
      "geometry": {
        "fillColor": "#f7e3f7"
      }
    },
    {
      "id": "natural.water",
      "geometry": {
        "fillColor": "#d4b2ff"
      },
      "label": {
        "textFillColor": "#3d2163",
        "textStrokeColor": "#f0e1ff"
      }
    },
    {
      "id": "pointOfInterest",
      "label": {
        "pinFillColor": "#e0349a",
        "textFillColor": "#a11e6e",
        "textStrokeColor": "#ffd9f0"
      }
    },
    {
      "id": "pointOfInterest.emergency.hospital",
      "geometry": {
        "fillColor": "#ffe3e3"
      }
    },
    {
      "id": "pointOfInterest.foodAndDrink",
      "label": {
        "visible": false
      }
    },
    {
      "id": "pointOfInterest.recreation.park",
      "geometry": {
        "fillColor": "#f9b9d2"
      }
    }
  ]
}

JSON 对象

JSON 样式声明包含一个顶级对象和一个样式规则数组。

顶级属性（可选）- 全局样式设置，例如 backgroundColor 和 variant。
styles - 样式规则对象数组，可以包含以下内容：
- id - 要为此样式修改选择的地图项（例如 pointOfInterest.recreation.park）。
- geometry（可选）- 地图项的几何图形元素以及要应用的样式规则（例如 fillColor）。
- label（可选）- 地图项的文本或图钉标签以及要应用的样式规则（例如 textStrokeColor）。

顶层属性

下表中的属性适用于整个地图样式。

属性	类型	说明	示例
`backgroundColor`	字符串	使用 #RRGGBB 十六进制字符串自定义地图应用的背景颜色。此设置不支持更改不透明度。	"#002211"
`variant`	"light"\|"dark"	指定浅色或深色模式。如果未指定，则默认值为“浅色”。	“light”
`monochrome`	布尔值	如需启用单色，请使用 `true` 获取地图的灰度版本。	`true`
`metadata`	对象	样式定义中包含的任意键值数据。您可以使用此字段来包含与样式相关的非样式内容。此数据不会发送到地图客户端（例如 Maps JavaScript SDK）。	`{"author": "me", "date": "2026-04-27"}`

样式规则对象

本部分介绍了 styles 数组中用于定义样式规则对象的属性，这些属性可用于自定义地图功能。每个样式规则对象都必须包含以下内容：

id 属性所定义）。
定义了关联的样式属性的 geometry 或 label 元素。

`id`（地图项）

id 属性用于指定要设置样式的地图项。属性名称是样式编辑器中地图项名称的驼峰式版本。

地图项构成类别树。如果您指定父级地图项类型（例如 pointOfInterest），则您为父级地图项指定的所有样式均会应用到其所有子级地图项（例如 pointOfInterest.retail 和 pointOfInterest.lodging）。如需了解详情，请参阅地图项层次结构。

可用 `id` 媒体资源列表

可用的 id 属性如下所示：

pointOfInterest
pointOfInterest.emergency
pointOfInterest.emergency.fire
pointOfInterest.emergency.hospital
pointOfInterest.emergency.pharmacy
pointOfInterest.emergency.police
pointOfInterest.entertainment
pointOfInterest.entertainment.arts
pointOfInterest.entertainment.casino
pointOfInterest.entertainment.cinema
pointOfInterest.entertainment.historic
pointOfInterest.entertainment.museum
pointOfInterest.entertainment.themePark
pointOfInterest.entertainment.touristAttraction
pointOfInterest.foodAndDrink
pointOfInterest.foodAndDrink.bar
pointOfInterest.foodAndDrink.cafe
pointOfInterest.foodAndDrink.restaurant
pointOfInterest.foodAndDrink.winery
pointOfInterest.landmark
pointOfInterest.lodging
pointOfInterest.recreation
pointOfInterest.recreation.beach
pointOfInterest.recreation.boating
pointOfInterest.recreation.fishing
pointOfInterest.recreation.golfCourse
pointOfInterest.recreation.hotSpring
pointOfInterest.recreation.natureReserve
pointOfInterest.recreation.park
pointOfInterest.recreation.peak
pointOfInterest.recreation.sportsComplex
pointOfInterest.recreation.sportsField
pointOfInterest.recreation.trailhead
pointOfInterest.recreation.zoo
pointOfInterest.retail
pointOfInterest.retail.grocery
pointOfInterest.retail.shopping
pointOfInterest.service
pointOfInterest.service.atm
pointOfInterest.service.bank
pointOfInterest.service.carRental
pointOfInterest.service.evCharging
pointOfInterest.service.gasStation
pointOfInterest.service.parkingLot
pointOfInterest.service.postOffice
pointOfInterest.service.restStop
pointOfInterest.service.restroom
pointOfInterest.transit
pointOfInterest.transit.airport
pointOfInterest.other
pointOfInterest.other.bridge
pointOfInterest.other.cemetery
pointOfInterest.other.government
pointOfInterest.other.library
pointOfInterest.other.military
pointOfInterest.other.placeOfWorship
pointOfInterest.other.school
pointOfInterest.other.townSquare
political
political.countryOrRegion
political.border
political.reservation
political.stateOrProvince
political.city
political.sublocality
political.neighborhood
political.landParcel
infrastructure
infrastructure.building
infrastructure.building.commercial
infrastructure.businessCorridor
infrastructure.roadNetwork
infrastructure.roadNetwork.noTraffic
infrastructure.roadNetwork.noTraffic.pedestrianMall
infrastructure.roadNetwork.noTraffic.trail
infrastructure.roadNetwork.noTraffic.trail.paved
infrastructure.roadNetwork.noTraffic.trail.unpaved
infrastructure.roadNetwork.parkingAisle
infrastructure.roadNetwork.ramp
infrastructure.roadNetwork.road
infrastructure.roadNetwork.road.arterial
infrastructure.roadNetwork.road.highway
infrastructure.roadNetwork.road.local
infrastructure.roadNetwork.road.noOutlet
infrastructure.roadNetwork.roadShield
infrastructure.roadNetwork.roadSign
infrastructure.roadNetwork.roadDetail
infrastructure.roadNetwork.roadDetail.surface
infrastructure.roadNetwork.roadDetail.crosswalk
infrastructure.roadNetwork.roadDetail.sidewalk
infrastructure.roadNetwork.roadDetail.intersection
infrastructure.railwayTrack
infrastructure.railwayTrack.commercial
infrastructure.railwayTrack.commuter
infrastructure.transitStation
infrastructure.transitStation.bicycleShare
infrastructure.transitStation.busStation
infrastructure.transitStation.ferryTerminal
infrastructure.transitStation.funicularStation
infrastructure.transitStation.gondolaStation
infrastructure.transitStation.monorail
infrastructure.transitStation.railStation
infrastructure.transitStation.railStation.subwayStation
infrastructure.transitStation.railStation.tramStation
infrastructure.urbanArea
natural
natural.continent
natural.archipelago
natural.island
natural.land
natural.land.landCover
natural.land.landCover.crops
natural.land.landCover.dryCrops
natural.land.landCover.forest
natural.land.landCover.ice
natural.land.landCover.sand
natural.land.landCover.shrub
natural.land.landCover.tundra
natural.water
natural.water.ocean
natural.water.lake
natural.water.river
natural.water.other
natural.base

元素

元素是地图项的细分。例如，在地图上，道路不仅包含图形线条（geometry），还包括指示其名称的文本（label）。

可用元素如下所示（但请注意，特定地图项可能不支持任何元素，也可能支持部分或全部元素）：

geometry：选择指定地图项的所有几何元素（例如，多边形、多段线）。
label：选择指定地图项的所有标签元素（例如文字、图钉）。

样式器

样式器用于为地图项的每个元素定义样式规则。

例如，对于建筑轮廓，您可以按如下方式设置每个元素的样式：

建筑物的 `geometry` 样式示例	建筑物的 `label` 样式示例
是否在地图上隐藏或显示建筑物基底多边形。	是否隐藏或显示建筑物标签。
多边形填充颜色和不透明度。	文本填充颜色和不透明度。
边框颜色、不透明度和宽度。	文本描边颜色和不透明度。

本部分介绍了可用于 geometry 和 label 元素的不同样式选项。

`geometry` 样式器

下表列出了所有可用的几何样式。

Styler	类型	说明
`visible`	布尔值	如需隐藏地图项的多边形或多段线，请设置为 `false`。
`fillColor`	字符串	使用 RGB 十六进制字符串自定义多边形或多段线的颜色。
`fillOpacity`	float	自定义多边形或多段线的不透明度，其中 0 表示透明，1 表示不透明。
`strokeColor`	字符串	使用 RGB 十六进制字符串自定义轮廓的颜色。
`strokeOpacity`	float	自定义轮廓的不透明度，其中 0 表示透明，1 表示不透明。
`strokeWeight`	float	自定义轮廓粗细，范围为 0 到 8。

如需了解详情，请参阅多边形和折线。

`label` 样式器

下表列出了所有可用的标签样式。

Styler	类型	说明
`visible`	布尔值	如需隐藏地图项的标签，请设置为 `false`。
`textFillColor`	字符串	使用 RGB 十六进制字符串自定义文本标签的颜色。
`textFillOpacity`	float	自定义文字标签的不透明度，其中 0 表示透明，1 表示不透明。
`textStrokeColor`	字符串	使用 RGB 十六进制字符串自定义轮廓的颜色。
`textStrokeOpacity`	float	自定义轮廓的不透明度，其中 0 表示透明，1 表示不透明。
`textStrokeWeight`	float	自定义轮廓粗细，范围为 0 到 8。
`pinFillColor`	字符串	使用 RGB 十六进制字符串自定义图钉颜色。
`pinGlyphColor`	字符串	使用 RGB 十六进制字符串自定义图钉内字形（图标）的颜色。
`pinOutlineColor`	字符串	使用 RGB 十六进制字符串自定义图钉轮廓的颜色。

如需了解详情，请参阅图标和文字标签。

Keyzoom

您可以为某个功能设置一种样式，使其适用于所有关键缩放级别，也可以为不同的关键缩放级别指定不同的样式。如果您只提供一种样式，则该样式将用于从 z0 开始的所有 keyzoom 级别。如果您为不同的关键缩放级别提供样式，则样式将从该缩放级别开始应用，直到您定义的下一个缩放级别。

如需为样式设置 keyzoom 级别，请在样式器属性中定义从 z0 到 z22 的 keyzoom 级别，然后定义样式器自定义设置。

在以下示例中，水域颜色在关键缩放级别 0-5 为黑色，在关键缩放级别 6-11 为深灰色，从关键缩放级别 12 开始为浅灰色。

{
  "id": "natural.water",
  "geometry": {
    "fillColor": {
      "z0": "#000000",
      "z6": "#666666",
      "z12": "#cccccc"
    }
  }
}

如需了解详情，请参阅样式缩放级别。

限制

您可以使用 JSON 为 Google Cloud 控制台中的几乎所有内容设置样式，但地图设置菜单中的以下选项除外：

这些地图级选项需要重新提取图块数据才能正确呈现，这在某些使用情形下可能并不理想。

对于这些选项，您必须在 地图设置菜单中选择偏好设置。

由于导出的样式中不包含这些选项，因此在导入样式时，必须在 Google Cloud 控制台中重新选择这些选项。

云端地图样式设置的 JSON 参考 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

查看 JSON 样式声明示例

JSON 对象

顶层属性

样式规则对象

id（地图项）

可用 id 媒体资源列表

元素

样式器

geometry 样式器

label 样式器

Keyzoom

限制

云端地图样式设置的 JSON 参考

`id`（地图项）

可用 `id` 媒体资源列表

`geometry` 样式器

`label` 样式器