使用入门

请选择平台： Android iOS JavaScript

请按照以下步骤设置边界的数据驱动型样式。

启用新版地图渲染程序

升级版地图渲染程序自 Maps SDK for Android 18.0.0 版起提供。此版本渲染程序针对 Maps SDK for Android 带来了许多的改进，包括对云端地图样式设置的支持。

随着 Maps SDK for Android 18.2.0 版的发布，Google 已将默认渲染程序从旧版渲染程序改为升级版地图渲染程序。此更改意味着，当您构建新应用或重新构建现有应用时，系统会在应用中默认使用升级版地图渲染程序。

注意： 如需在应用中使用边界的数据驱动型样式，应用必须 使用升级版地图渲染程序制作而成。如果您要添加 现有应用边界的数据驱动型样式，请确保重新构建 应用，以便您的应用使用升级版地图渲染程序。如需了解详情，请参阅新版地图渲染程序。

创建地图 ID

如要创建新的地图 ID，请按照创建地图 ID 中的步骤操作。请确保将地图类型设置为 Android。

创建新的地图样式

如要创建新的地图样式，请按照管理地图样式一文中的说明创建样式，并将该样式与您刚刚创建的地图 ID 相关联。

选择新地图样式中的地图项图层

在 Google API 控制台中，您可以选择要显示的地图项图层 创建新的地图样式。地图项图层决定了哪些类型的边界 （例如市行政区、州/省/自治区/直辖市等）显示在地图上。

重要提示：为了获得最佳性能，请仅选择您需要的图层。

1. 在 Google API 控制台中，前往“地图样式”页面。
2. 根据系统提示选择一个项目。
3. 选择地图样式。
4. 点击地图项图层下拉菜单，添加或移除图层。
5. 点击保存，从而保存您所做的更改并使其可在地图中使用。

更新地图初始化代码

此步骤需要用到您刚刚创建的地图 ID。您可以在 地图管理页面。

如要将该地图 ID 添加到您的初始化代码，请参阅将地图 ID 添加到应用。

获取地图地图项图层的访问权限

您使用的是FeatureLayer 对象来表示地图的各个地图项图层，例如邮政编码或 市行政区地图项图层。要获取地图项图层对象的访问权限，请调用 GoogleMap.getFeatureLayer() 当地图初始化时：

Java

private FeatureLayer postalCodeLayer;

@Override
public void onMapReady(GoogleMap map) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build());
  ...
}

Kotlin

private var postalCodeLayer: FeatureLayer? = null

override fun onMapReady(googleMap: GoogleMap) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = googleMap.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build())
  ...
}

传递 FeatureLayerOptions 对象设置为 getFeatureLayer()，以指定地图项图层的类型。在本课中， 例如，您想要访问 POSTAL_CODE 图层。创建另一个 FeatureLayer 对象。

有了 FeatureLayer 对象后，您就可以将样式应用于 绘制边界多边形。

注意 ：如果地图不存在指定类型的 FeatureLayer，或者 如果未启用边界的数据驱动型样式， 指定了地图 ID，则此调用会返回但会记录错误。使用 FeatureLayer.isAvailable() 方法来确定 FeatureLayer 是否可用。

检查地图功能（必选）

边界的数据驱动型样式需要地图 ID。如果地图 ID 缺失，或者 传递的地图 ID 无效，无法加载边界的数据驱动型样式。作为 问题排查步骤，您可以使用 MapCapabilities 检查是否支持边界的数据驱动型样式。

注意 ：某些设备可能不支持新版地图渲染程序， 无法显示边界的数据驱动型样式。请务必在运行时使用 MapCapabilities 检查设备是否支持高级标记。如果 不支持边界的数据驱动型样式，请定义后备选项。 如需了解新版地图渲染程序的设备要求，请参阅支持 设备。

Kotlin

val capabilities: MapCapabilities = googleMap.getMapCapabilities()
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable())

Java

MapCapabilities capabilities = googleMap.getMapCapabilities();
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable());