将数据集添加到地图

请选择平台： 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（例如，需要让部分地图项保持不可见状态时）。