Thêm tập dữ liệu vào tập dữ liệu bản đồ và kiểu

Chọn nền tảng: Android iOS JavaScript

Trang này hướng dẫn bạn cách thêm tập dữ liệu vào bản đồ và áp dụng kiểu.

Ảnh chụp màn hình cho thấy dữ liệu đa giác có kiểu.

Điều kiện tiên quyết

Trước khi tiếp tục, bạn cần có mã bản đồ, kiểu bản đồ và mã tập dữ liệu.

Tạo mã bản đồ và kiểu bản đồ
Tạo và tải tập dữ liệu lên

Lưu ý: Bạn cần có mã tập dữ liệu để khởi chạy ứng dụng.

Liên kết mã tập dữ liệu với kiểu bản đồ

Để tạo kiểu cho các đối tượng của tập dữ liệu, bạn hãy áp dụng hàm kiểu cho lớp đối tượng tập dữ liệu của bản đồ. Lớp đối tượng tập dữ liệu được tạo khi bạn liên kết tập dữ liệu với kiểu bản đồ.

Cách liên kết tập dữ liệu với kiểu bản đồ:

Trong bảng điều khiển Cloud, hãy chuyển đến trang Tập dữ liệu.
Nhấp vào tên của tập dữ liệu. Trang Chi tiết tập dữ liệu sẽ xuất hiện.
Nhấp vào thẻ Xem trước.
Trong phần Kiểu bản đồ được liên kết, hãy nhấp vào THÊM KIỂU BẢN ĐỒ.
Nhấp vào(các) hộp kiểm cho(các) Kiểu bản đồ cần liên kết, rồi nhấp vào LƯU.

Áp dụng kiểu cho tập dữ liệu

Cách áp dụng kiểu cho tập dữ liệu:

Tạo hàm nhà máy kiểu triển khai FeatureLayer.StyleFactory giao diện. Hàm này xác định logic tạo kiểu cho tập dữ liệu.
Gọi FeatureLayer.setFeatureStyle() để áp dụng hàm nhà máy kiểu cho từng tính năng trong tập dữ liệu.

Tạo hàm nhà máy kiểu

Hàm factory kiểu được áp dụng cho mọi đối tượng trong lớp tập dữ liệu tại thời điểm bạn đặt hàm trên lớp đối tượng. Hàm này phải trả về đối tượng FeatureStyle chỉ định cách tạo kiểu cho đa giác.

Nếu factory kiểu trả về null, thì tính năng đã cho sẽ không được hiển thị. Để biết thêm thông tin, hãy xem bài viết Xoá kiểu khỏi lớp.

Maps SDK cho Android truyền một Feature thực thể đến hàm nhà máy kiểu. Thực thể Feature đại diện cho siêu dữ liệu của tính năng, cho phép bạn truy cập vào siêu dữ liệu trong hàm nhà máy kiểu.

Hàm factory kiểu phải luôn trả về kết quả nhất quán khi được áp dụng. Ví dụ: nếu bạn muốn tô màu ngẫu nhiên cho một tập hợp tính năng, thì phần ngẫu nhiên không được diễn ra trong hàm kiểu tính năng, vì điều đó sẽ gây ra kết quả không mong muốn.

Vì hàm này chạy trên mọi tính năng trong một lớp, nên việc tối ưu hoá là rất quan trọng. Để tránh ảnh hưởng đến thời gian kết xuất, hãy gọi FeatureLayer.setFeatureStyle(null) khi không còn sử dụng lớp đối tượng nữa.

Bạn cũng có thể gọi FeatureLayer.getDatasetId() để lấy mã của tập dữ liệu.

Đặt bán kính nét, màu nền và điểm

Khi tạo kiểu cho một tính năng trong hàm nhà máy kiểu, bạn có thể đặt:

Màu nét và độ mờ của đường viền do Color xác định. Giá trị mặc định là trong suốt (Color.TRANSPARENT).
Chiều rộng nét của đường viền tính bằng pixel trên màn hình. Giá trị mặc định là 2.
Màu nền và độ mờ do Color lớp xác định. Giá trị mặc định là trong suốt (Color.TRANSPARENT).
Bán kính điểm của tính năng điểm từ 0 đến 128 pixel.

Sử dụng quy tắc kiểu đơn giản

Cách đơn giản nhất để tạo kiểu cho các tính năng là xác định FeatureLayer.StyleFactory luôn tạo đối tượng FeatureStyle giống hệt nhau, bất kể tính năng đó là gì. Áp dụng trực tiếp các tuỳ chọn kiểu tính năng cho lớp đối tượng tập dữ liệu hoặc sử dụng các tuỳ chọn này cùng với FeatureStyleFunction.

Sử dụng quy tắc kiểu khai báo

Bạn có thể đặt quy tắc kiểu theo cách khai báo dựa trên thuộc tính tính năng và áp dụng các quy tắc này trên toàn bộ tập dữ liệu. Bạn có thể trả về null từ hàm kiểu tính năng, chẳng hạn như nếu bạn muốn một tập hợp con các tính năng vẫn ở trạng thái ẩn.

Ví dụ: sử dụng phương thức DatasetFeature.getDatasetAttributes() để trả về Map<String,String> của các thuộc tính tập dữ liệu cho một tính năng. Sau đó, bạn có thể tuỳ chỉnh kiểu của tính năng dựa trên các thuộc tính của tính năng đó.

Ví dụ này xác định giá trị của thuộc tính "highlightColor" của từng tính năng trong tập dữ liệu để kiểm soát kiểu:

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;
}

Áp dụng kiểu cho lớp đối tượng tập dữ liệu

Ví dụ này áp dụng hàm factory kiểu cho một đa giác trong lớp đối tượng tập dữ liệu. Hàm factory kiểu áp dụng kiểu nét và màu nền tuỳ chỉnh cho đa giác:

Nếu bạn chưa làm như vậy, hãy làm theo các bước trong Bắt đầu để tạo mã bản đồ và kiểu bản đồ mới. Nhớ bật lớp đối tượng Tập dữ liệu.

Lấy tham chiếu đến lớp đối tượng Tập dữ liệu khi bản đồ khởi chạy.

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();
}

Tạo hàm factory kiểu và áp dụng hàm này cho lớp đối tượng Tập dữ liệu.

Ví dụ sau áp dụng cùng một màu nền và nét cho tất cả các tính năng trong tập dữ liệu.

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(2)
          .build();
      }
      return null;
    };

    // Apply the style factory function to the feature layer.
    datasetLayer.setFeatureStyle(styleFactory);
}

Xoá kiểu khỏi lớp

Để xoá kiểu khỏi lớp, hãy gọi FeatureLayer.setFeatureStyle(null).

Bạn cũng có thể trả về null từ nhà máy kiểu, chẳng hạn như nếu bạn muốn một tập hợp con các tính năng vẫn ở trạng thái ẩn.

Thêm tập dữ liệu vào tập dữ liệu bản đồ và kiểu Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Điều kiện tiên quyết

Liên kết mã tập dữ liệu với kiểu bản đồ

Áp dụng kiểu cho tập dữ liệu

Tạo hàm nhà máy kiểu

Đặt bán kính nét, màu nền và điểm

Sử dụng quy tắc kiểu đơn giản

Sử dụng quy tắc kiểu khai báo

Kotlin

Java

Áp dụng kiểu cho lớp đối tượng tập dữ liệu

Kotlin

Java

Kotlin

Java

Xoá kiểu khỏi lớp

Thêm tập dữ liệu vào tập dữ liệu bản đồ và kiểu