将数据集添加到地图

请选择平台： Android iOS JavaScript

FeatureStyleFunction 用于定义逻辑，以在数据集内有选择性地设置地图项的样式。它会根据定义的逻辑返回 FeatureStyleOptions。如果不需要样式设置逻辑，您可以使用 FeatureStyleOptions 直接设置样式。本页面介绍了如何将数据集添加到地图以及如何应用样式设置。

前提条件

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

• 创建地图 ID 和地图样式
• 创建并上传数据集

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

实验性： 此功能只能针对浅色地图样式进行设置。如果您将启用了此功能的浅色地图样式与地图 ID 相关联，那么启用的图层也可用于深色地图样式。

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

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

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

使用简单的样式规则

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

TypeScript

const styleOptions = {
    strokeColor: 'green',
    strokeWeight: 2,
    strokeOpacity: 1,
    fillColor: 'green',
    fillOpacity: 0.3,
};
index.ts

注意：请参阅 TypeScript 和 Google 地图的使用方法指南。

JavaScript

const styleOptions = {
    strokeColor: 'green',
    strokeWeight: 2,
    strokeOpacity: 1,
    fillColor: 'green',
    fillOpacity: 0.3,
};
index.js

使用声明式样式规则

您可以通过 FeatureStyleFunction 以声明的方式设置样式规则，并将其应用于整个数据集。然后根据数据集属性值将 FeatureStyleOptions 应用于地图项。您还可以从地图项样式函数返回 null（例如，需要让部分地图项保持不可见状态时）。下例中的样式函数可根据数据属性为一组点着色：

TypeScript

function setStyle(/* FeatureStyleFunctionOptions */ params) {
    // Get the dataset feature, so we can work with all of its attributes.
    const datasetFeature = params.feature;
    // Get all of the needed dataset attributes.
    const furColors = datasetFeature.datasetAttributes['CombinationofPrimaryandHighlightColor'];

    // Apply styles. Fill is primary fur color, stroke is secondary fur color.
    switch (furColors) {
        case 'Black+':
            return /* FeatureStyleOptions */ { fillColor: 'black', pointRadius: 8 };
            break;
        case 'Cinnamon+':
            return /* FeatureStyleOptions */ { fillColor: '#8b0000', pointRadius: 8 };
            break;
        case 'Cinnamon+Gray':
            return /* FeatureStyleOptions */ { fillColor: '#8b0000', strokeColor: 'gray', pointRadius: 6 };
            break;
        case 'Cinnamon+White':
            return /* FeatureStyleOptions */ { fillColor: '#8b0000', strokeColor: 'white', pointRadius: 6 };
            break;
        case 'Gray+':
            return /* FeatureStyleOptions */ { fillColor: 'gray', pointRadius: 8 };
            break;
        case 'Gray+Cinnamon':
            return /* FeatureStyleOptions */ { fillColor: 'gray', strokeColor: '#8b0000', pointRadius: 6 };
            break;
        case 'Gray+Cinnamon, White':
            return /* FeatureStyleOptions */ { fillColor: 'silver', strokeColor: '#8b0000', pointRadius: 6 };
            break;
        case 'Gray+White':
            return /* FeatureStyleOptions */ { fillColor: 'gray', strokeColor: 'white', pointRadius: 6 };
            break;
        default: // Color not defined.
            return /* FeatureStyleOptions */ { fillColor: 'yellow', pointRadius: 8 };
            break; 
    }
}
index.ts

注意：请参阅 TypeScript 和 Google 地图的使用方法指南。

JavaScript

function setStyle(/* FeatureStyleFunctionOptions */ params) {
    // Get the dataset feature, so we can work with all of its attributes.
    const datasetFeature = params.feature;
    // Get all of the needed dataset attributes.
    const furColors = datasetFeature.datasetAttributes['CombinationofPrimaryandHighlightColor'];
    // Apply styles. Fill is primary fur color, stroke is secondary fur color.
    switch (furColors) {
        case 'Black+':
            return /* FeatureStyleOptions */ { fillColor: 'black', pointRadius: 8 };
            break;
        case 'Cinnamon+':
            return /* FeatureStyleOptions */ { fillColor: '#8b0000', pointRadius: 8 };
            break;
        case 'Cinnamon+Gray':
            return /* FeatureStyleOptions */ { fillColor: '#8b0000', strokeColor: 'gray', pointRadius: 6 };
            break;
        case 'Cinnamon+White':
            return /* FeatureStyleOptions */ { fillColor: '#8b0000', strokeColor: 'white', pointRadius: 6 };
            break;
        case 'Gray+':
            return /* FeatureStyleOptions */ { fillColor: 'gray', pointRadius: 8 };
            break;
        case 'Gray+Cinnamon':
            return /* FeatureStyleOptions */ { fillColor: 'gray', strokeColor: '#8b0000', pointRadius: 6 };
            break;
        case 'Gray+Cinnamon, White':
            return /* FeatureStyleOptions */ { fillColor: 'silver', strokeColor: '#8b0000', pointRadius: 6 };
            break;
        case 'Gray+White':
            return /* FeatureStyleOptions */ { fillColor: 'gray', strokeColor: 'white', pointRadius: 6 };
            break;
        default: // Color not defined.
            return /* FeatureStyleOptions */ { fillColor: 'yellow', pointRadius: 8 };
            break;
    }
}
index.js

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

如要在地图项样式函数中应用样式，请执行以下操作：

1. 调用 map.getDatasetFeatureLayer() 并传递数据集 ID，以获取数据集地图项图层。
2. 为数据集图层设置地图项样式选项（例如 styleOptions）或函数（例如 setStyle），以应用样式。

TypeScript

// Dataset ID for NYC park data.
const datasetId = 'a75dd002-ad20-4fe6-af60-27cd2ed636b4';

const datasetLayer = innerMap.getDatasetFeatureLayer(datasetId);
datasetLayer.style = styleOptions;
index.ts

注意：请参阅 TypeScript 和 Google 地图的使用方法指南。

JavaScript

// Dataset ID for NYC park data.
const datasetId = 'a75dd002-ad20-4fe6-af60-27cd2ed636b4';
const datasetLayer = innerMap.getDatasetFeatureLayer(datasetId);
datasetLayer.style = styleOptions;
index.js

移除图层的样式

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

featureLayer.style = null;

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

添加提供方说明文本

在 Google 地图上显示已上传的数据集时，您的地图必须显示所有必要的提供方说明。提供方说明文本不得遮挡或干扰 Google 徽标。

要添加提供方说明文本，您可以使用自定义控件将任意 HTML 放置在地图上的标准位置。以下代码段展示了此示例中用于提供方信息的 HTML 和 CSS：

<gmp-map center="40.757815, -73.933123" zoom="11" map-id="5cd2c9ca1cf05670" map-type-control="false">
  <div id="attribution" slot="control-block-end-inline-start">Data source: NYC Open Data</div>
</gmp-map>
index.html

#attribution {
  background-color: rgba(255, 255, 255, 0.7);
  font-family: "Roboto", "Arial", "sans-serif";
  font-size: 10px;
  padding: 2px;
  margin: 2px;
}
style.css