将数据集添加到地图

请选择平台： Android iOS JavaScript

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

前提条件

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

• 创建地图 ID 和地图样式

• 创建并上传数据集

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

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

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

如要将您的数据集与您使用的地图样式相关联，请按以下步骤操作：

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

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

将样式应用于数据集

如需为数据集图层的地图项设置样式，请使用接受 GMSDatasetFeature 并返回 GMSFeatureStyle 的样式封闭来定义样式属性。然后，将样式属性设置为包含样式设置逻辑的样式封闭函数。

样式封闭必须是确定性的，并且在应用时返回一致的结果。如果任何地图项的任何样式规范发生更改，则必须重新应用样式。

设置描边、填充和点半径

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

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

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

• 填充颜色和不透明度，由 UIColor 类定义。默认值为透明 (UIColor.clearColor)。

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

注意 ：如果您希望某个地图项不可见，请从该地图项的样式函数返回 nil。

使用简单的样式规则

设置地图项样式时，最简单的方式是定义颜色、不透明度和线条粗细等常量样式属性。您可以直接将地图项样式选项应用于数据集地图项图层，也可以将这些选项与自定义样式搭配使用。

Swift

let mapView = GMSMapView(frame: .zero, mapID: GMSMapID(identifier: "YOUR_MAP_ID"), camera: GMSCameraPosition(latitude: 40.7, longitude: -74.0, zoom: 12))

let layer = mapView.datasetFeatureLayer(of: "YOUR_DATASET_ID")

// Define a style with green fill and stroke.
// Apply the style to all features in the dataset.
layer.style = { feature in
    let style = MutableFeatureStyle()
    style.fillColor = .green.withAlphaComponent(0.1)
    style.strokeColor = .green
    style.strokeWidth = 2.0
    return style
}

Objective-C

GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:[GMSMapID mapIDWithIdentifier:@"MAP_ID"] camera:[GMSCameraPosition cameraWithLatitude: 40.7 longitude: -74.0 zoom:12]];

GMSDatasetFeatureLayer *layer = [mapView datasetFeatureLayerOfDatasetID:@"YOUR_DATASET_ID"];

// Define a style with green fill and stroke.
// Apply the style to all features in the dataset.
layer.style = ^(GMSDatasetFeature *feature) {
    GMSMutableFeatureStyle *style = [GMSMutableFeatureStyle style];
    style.fillColor = [[UIColor greenColor] colorWithAlphaComponent:0.1];
    style.strokeColor = [UIColor greenColor];
    style.strokeWidth = 2.0;
    return style;
};

使用声明式样式规则

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

例如，使用 GMSDatasetFeature.datasetAttributes 可返回地图项的数据集属性的值。然后，您可以根据地图项的属性自定义其样式。

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

Swift

layer.style = { feature in
    var attributeColor: String = feature.datasetAttributes["highlightColor"]
    // Conditionalize styling based on the value of the "highlightColor" attribute.
    ...
}

Objective-C

// Apply the style to a single dataset feature.
layer.style = ^(GMSDatasetFeature *feature) {
    NSString *attributeColor = feature.datasetAttributes[@"highlightColor"];
    // Conditionalize styling based on the value of the "highlightColor" attribute.
    ...
};

移除图层的样式

如需移除图层的样式，请将 style 设置为 null：

Swift

layer.style = nil

Objective-C

layer.style = nil;

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