将数据集添加到地图

本产品或功能目前为正式发布前的预览版。正式发布前的产品和功能获得的支持可能较为有限，并且对其作出的更改可能不兼容其他正式发布前版本。正式发布前的产品或功能受《Google Maps Platform 服务专用条款》约束。如需了解详情，请参阅发布阶段说明。

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

前提条件

在继续操作之前，您应备好地图 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

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

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

JavaScript

const datasetLayer = map.getDatasetFeatureLayer(datasetId);

datasetLayer.style = styleOptions;
index.js

移除图层的样式

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

featureLayer.style = null;

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

添加提供方说明文本

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

要添加提供方说明文本，您可以使用自定义控件将任意 HTML 放置在地图上的标准位置。以下代码示例中所示的函数通过程序化方式创建了此类自定义控件：

TypeScript

function createAttribution(map) {
    const attributionLabel = document.createElement('div');
    // Define CSS styles.
    attributionLabel.style.backgroundColor = '#fff';
    attributionLabel.style.opacity = '0.7';
    attributionLabel.style.fontFamily = 'Roboto,Arial,sans-serif';
    attributionLabel.style.fontSize = '10px';
    attributionLabel.style.padding = '2px';
    attributionLabel.style.margin = '2px';
    attributionLabel.textContent = 'Data source: NYC Open Data';
    return attributionLabel;
}
index.ts

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

JavaScript

function createAttribution(map) {
  const attributionLabel = document.createElement("div");

  // Define CSS styles.
  attributionLabel.style.backgroundColor = "#fff";
  attributionLabel.style.opacity = "0.7";
  attributionLabel.style.fontFamily = "Roboto,Arial,sans-serif";
  attributionLabel.style.fontSize = "10px";
  attributionLabel.style.padding = "2px";
  attributionLabel.style.margin = "2px";
  attributionLabel.textContent = "Data source: NYC Open Data";
  return attributionLabel;
}
index.js

定义控件后，您便可以在初始化时将其添加到地图中，如下所示：

TypeScript

// Create an attribution DIV and add the attribution to the map.
const attributionDiv = document.createElement('div');
const attributionControl = createAttribution(map);
attributionDiv.appendChild(attributionControl);
map.controls[google.maps.ControlPosition.LEFT_BOTTOM].push(attributionDiv);
index.ts

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

JavaScript

// Create an attribution DIV and add the attribution to the map.
const attributionDiv = document.createElement("div");
const attributionControl = createAttribution(map);

attributionDiv.appendChild(attributionControl);
map.controls[google.maps.ControlPosition.LEFT_BOTTOM].push(attributionDiv);
index.js