Kiểu bản đồ mới sắp xuất hiện trên Nền tảng Google Maps. Bản cập nhật này để tạo kiểu bản đồ bao gồm một bảng màu mặc định mới và các cải tiến về trải nghiệm bản đồ cũng như khả năng hữu dụng. Tất cả kiểu bản đồ sẽ được cập nhật tự động vào tháng 3 năm 2025. Để biết thêm thông tin về phạm vi cung cấp và cách chọn tham gia sớm hơn, hãy xem bài viết Kiểu bản đồ mới cho Nền tảng Google Maps.

Trang này được dịch bởi Cloud Translation API.

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 cho bạn biết 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 hiển thị dữ liệu đa giác được tạo kiểu.

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

Trước khi tiếp tục, bạn phải 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ã nhận dạng của 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 đặc điểm của một tập dữ liệu, bạn áp dụng hàm kiểu cho lớp đặc điểm của tập dữ liệu của bản đồ. Lớp đối tượng của 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 Google Cloud Console, hãy truy cập vào trang Tập dữ liệu.
Nhấp vào tên của tập dữ liệu. Trang Thông tin chi tiết về 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 đánh dấu 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 một hàm nhà máy kiểu triển khai giao diện FeatureLayer.StyleFactory. Hàm này xác định logic định kiểu cho một tập dữ liệu.
Gọi FeatureLayer.setFeatureStyle() để áp dụng hàm nhà máy kiểu cho từng đặc điểm trong tập dữ liệu.

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

Hàm nhà máy 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ề một FeatureStyle chỉ định cách tạo kiểu cho đa giác.

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

SDK Bản đồ dành cho Android sẽ truyền một thực thể Feature đế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 style factory .

Hàm factory kiểu phải luôn trả về kết quả nhất quán khi áp dụng. Ví dụ: nếu bạn muốn tô màu ngẫu nhiên một tập hợp các đối tượng, phần ngẫu nhiên không nên 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 lớp đối tượng không còn được sử dụng.

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

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

Khi tạo kiểu cho một đối tượng trong hàm factory tạo kiểu, bạn có thể đặt:

Màu và độ mờ nét vẽ của đường viền như được xác định bằng Color . Giá trị mặc định là trong suốt (Color.TRANSPARENT).
Độ rộng nét vẽ của đường viền tính bằng pixel màn hình. Giá trị mặc định là 2.
Màu tô và độ mờ do lớp Color xác định. Giá trị mặc định là trong suốt (Color.TRANSPARENT).
Bán kính điểm của một đối tượng điểm nằm trong khoảng 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 một FeatureLayer.StyleFactory luôn tạo một đối tượng FeatureStyle giống hệt, bất kể tính năng. Áp dụng trực tiếp các kiểu tính năng cho một lớp đối tượng tập dữ liệu hoặc sử dụng chúng cùng với FeatureStyleFunction.

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

Bạn có thể thiết lập các quy tắc kiểu theo cách khai báo dựa trên thuộc tính đối tượng và áp dụng các quy tắc đó cho toàn bộ tập dữ liệu. Bạn có thể trả lại null trong hàm kiểu tính năng, ví dụ: nếu bạn muốn giữ lại một số tính năng không hiển thị.

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

Ví dụ này xác định giá trị của thuộc tính "highlightColor" của từng đặc điểm trong một 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 tập dữ liệu lớp đối tượng. Hàm nhà máy kiểu áp dụng kiểu tô và nét tuỳ chỉnh cho đa giác:

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

Lấy thông tin 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 một hàm factory kiểu và áp dụng cho Tập dữ liệu lớp đối tượng.

Ví dụ sau đây áp dụng cùng một màu nền và nét vẽ cho tất cả các đối tượ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 một lớp

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

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