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

请选择平台： 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 和地图样式。请务必启用数据集 地图项图层。

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(2F)
             .build();
         }
         return null;
       };
   
       // Apply the style factory function to the feature layer.
       datasetLayer.setFeatureStyle(styleFactory);
   }
   

移除图层的样式

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

您还可以从样式工厂返回 null，例如， 希望部分特征保持不可见状态。