将数据集添加到地图和样式数据集

请选择平台： Android iOS JavaScript

本页介绍了如何将数据集添加到地图以及如何应用样式设置。

前提条件

在继续操作之前，您应备好地图 ID、地图样式和数据集 ID。

• 创建地图 ID 和地图样式

• 创建并上传数据集

  注意 ：您需要数据集的 ID 才能初始化应用。

将数据集 ID 与地图样式相关联

若要为数据集的地图项设置样式，您需要将样式函数应用于地图的数据集地图项图层。当您将数据集与地图样式相关联时，系统会创建数据集地图项图层。

如需将数据集与地图样式相关联，请执行以下操作：

1. 在 Google Cloud 控制台中，前往数据集页面。
2. 点击相应数据集的名称。系统随即会显示数据集详细信息页面。
3. 点击预览标签页。
4. 在关联的地图样式部分中，点击添加地图样式。
   
5. 勾选要关联的地图样式对应的复选框，然后点击保存。

注意：如果在地图上渲染多个数据集，可能会影响效果，具体取决于数据集的大小和数量。

将样式应用于数据集

如需向数据集应用样式，请执行以下操作：

1. 创建一个实现 FeatureLayer.StyleFactory 接口的样式工厂函数。此函数用于定义数据集的样式设置逻辑。

2. 调用 FeatureLayer.setFeatureStyle() 可将样式工厂函数应用于数据集中的每个地图项。

创建样式工厂函数

在您在地图项图层上设置样式工厂函数时，系统会将该函数应用于数据集图层中的每个地图项。此函数必须返回一个 FeatureStyle 对象，用于指定如何设置多边形的样式。

如果样式工厂返回 null，则系统不会渲染给定地图项。如需了解详情，请参阅从图层中移除样式。

注意 ：如果您更新或修改地图项图层的样式工厂函数，则必须再次调用 FeatureLayer.setFeatureStyle() 才能重置地图项图层上的函数。

Maps SDK for Android 会将 Feature 实例传递给样式工厂函数。Feature 实例表示地图项的元数据，可让您访问样式工厂函数中的元数据。

注意 ：对于数据集，实例实际上是 DatasetFeature 类型，它是 Feature 的子类。

应用样式工厂函数时，样式工厂函数应始终返回一致的结果。例如，如果要随机为一组地图项着色，不应针对随机部分应用地图项样式函数，否则会导致意外结果。

由于此函数会针对图层中的每个地图项运行，因此优化至关重要。为避免影响渲染时间，请在不再使用地图项图层时调用 FeatureLayer.setFeatureStyle(null)。

您还可以调用 FeatureLayer.getDatasetId() 来获取数据集的 ID。

设置描边、填充和点半径

在样式工厂函数中为地图项设置样式时，您可以设置以下属性：

• 边框的描边颜色和不透明度，由 Color 类定义。默认值为透明 (Color.TRANSPARENT)。

• 边框的描边宽度（以屏幕像素为单位）。默认值为 2。

• Color 类定义的填充颜色和不透明度。默认值为透明 (Color.TRANSPARENT)。

• 点地图项的点半径（介于 0 到 128 像素之间）。

使用简单的样式规则

若要设置地图项样式，最简单的方式是定义一个 FeatureLayer.StyleFactory，无论地图项如何，它始终会构建完全相同的 FeatureStyle 对象。您可以直接将地图项样式选项应用于数据集地图项图层，也可以将这些选项与 FeatureStyleFunction 搭配使用。

使用声明式样式规则

您可以根据地图项属性以声明方式设置样式规则，并将其应用于整个数据集。您可以从地图项样式函数返回 null（例如，需要让部分地图项保持不可见状态时）。

例如，使用 DatasetFeature.getDatasetAttributes() 方法返回地图项的数据集属性的 Map<String,String>。然后，您可以根据地图项的属性自定义其样式。

以下示例确定数据集的每个地图项的“highlightColor”属性的值，以控制样式：

Kotlin

// Get the dataset feature, so we can work with all of its attributes.
val datasetFeature: DatasetFeature = feature as DatasetFeature

// Create a switch statement based on the value of the
// "highlightColor" attribute of the dataset.
val attributeColor: MutableMap<String, String> = datasetFeature.getDatasetAttributes()
when (attributeColor["highlightColor"]) {
  "Black" -> {
    ...
  }
  "Red" -> {
    ...
  }
  else -> {
    ...
  }
}

Java

// Get the dataset feature, so we can work with all of its attributes.
DatasetFeature datasetFeature = (DatasetFeature) feature;

// Create a switch statement based on the value of the
// "highlightColor" attribute of the dataset.
Map<String, String> attributeColor = datasetFeature.getDatasetAttributes();
switch(attributeColor.get("highlightColor"))
{
  case "Black":
    ...
    break;
  case "Red":
    ...
    break;
  default: // Color not defined.
    ...
    break;
}

将样式应用于数据集地图项图层

此示例将样式工厂函数应用于数据集地图项图层中的多边形。样式工厂函数会将自定义填充和描边样式应用于多边形：

1. 按照开始使用中的步骤创建新的地图 ID 和地图样式（如果您尚未执行此操作）。请务必启用 Datasets（数据集）地图项图层。

2. 在地图初始化时获取对“数据集”地图项图层的引用。

   Kotlin

   private var datasetLayer: FeatureLayer? = null
   
   override fun onMapReady(googleMap: GoogleMap) {
     // Get the DATASET feature layer.
     datasetLayer = googleMap.getFeatureLayer(FeatureLayerOptions.Builder()
       .featureType(FeatureType.DATASET)
       // Specify the dataset ID.
       .datasetId(YOUR_DATASET_ID)
       .build())
   
     // Apply style factory function to DATASET layer.
     styleDatasetsLayer()
   }

   Java

   private FeatureLayer datasetLayer;
   
   @Override
   public void onMapReady(GoogleMap map) {
     // Get the DATASET feature layer.
     datasetLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
       .featureType(FeatureType.DATASET)
       // Specify the dataset ID.
       .datasetId(YOUR_DATASET_ID)
       .build());
   
     // Apply style factory function to DATASET layer.
     styleDatasetsLayer();
   }

3. 创建一个样式工厂函数，并将其应用于“数据集”地图项图层。

   以下示例会将相同的填充和描边应用于数据集中的所有地图项。

   注意 ：此示例会检查传递给样式工厂函数的特征是否为 DatasetFeature 类型。不过，由于样式工厂函数会将相同的样式应用于数据集中的所有地图项，因此它不会使用 DatasetFeature 对象。如需查看根据 DatasetFeature 对象的内容有条件地应用样式的示例，请参阅设置数据地图项样式的示例。

   Kotlin

   private fun styleDatasetsLayer() {
   
     // Create the style factory function.
     val styleFactory = FeatureLayer.StyleFactory { feature: Feature ->
   
         // Check if the feature is an instance of DatasetFeature.
         if (feature is DatasetFeature) {
   
               return@StyleFactory FeatureStyle.Builder()
                   // Define a style with green fill at 50% opacity and
                   // solid green border.
                   .fillColor(0x8000ff00.toInt())
                   .strokeColor(0xff00ff00.toInt())
                   .strokeWidth(2F)
                   .build()
         }
         return@StyleFactory null
     }
   
     // Apply the style factory function to the feature layer.
     datasetLayer?.setFeatureStyle(styleFactory)
   }

   Java

   private void styleDatasetsLayer() {
   
     // Create the style factory function.
     FeatureLayer.StyleFactory styleFactory = (Feature feature) -> {
   
       // Check if the feature is an instance of DatasetFeature.
       if (feature instanceof DatasetFeature) {
   
           return new FeatureStyle.Builder()
             // Define a style with green fill at 50% opacity and solid green border.
             .fillColor(0x8000ff00)
             .strokeColor(0xff00ff00)
             .strokeWidth(2)
             .build();
         }
         return null;
       };
   
       // Apply the style factory function to the feature layer.
       datasetLayer.setFeatureStyle(styleFactory);
   }

移除图层的样式

如需移除图层的样式，请调用 FeatureLayer.setFeatureStyle(null)。

您还可以从样式工厂返回 null（例如，需要让部分地图项保持不可见状态时）。