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 mã nhận dạng của tập dữ liệu để khởi chạy ứng dụng.

Liên kết mã nhận dạng 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 tập dữ liệu được tạo khi bạn liên kết mộ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 chuyển đến trang Tập dữ liệu.
Nhấp vào tên 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 mục Kiểu bản đồ 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 một 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 đối tượng 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 Maps dành cho Android truyền một bản sao Feature đến hàm factory tạo 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 factory kiểu.

Hàm nhà máy 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 các đối tượng, thì phần ngẫu nhiên không được diễn ra trong hàm kiểu đối tượng, vì điều đó sẽ gây ra kết quả ngoài 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 một lớp tính nă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 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ờ của nét vẽ của đường viền như được xác định bằng lớp 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ờ như được xác định bằng lớp Color. 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 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 nhau, bất kể tính năng là gì. Áp dụng trực tiếp các tuỳ chọn kiểu đối tượng cho lớp đối tượng của tập dữ liệu hoặc sử dụng các tuỳ chọn đó 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ả 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 ẩn.

Ví dụ: sử dụng phương thức DatasetFeature.getDatasetAttributes() để trả về một Map<String,String> gồm các 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 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 đặ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 của tập dữ liệu

Ví dụ này áp dụng hàm nhà máy kiểu cho một đa giác trong lớp đối tượng của tập dữ liệu. 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 lớp đối tượng Tập dữ liệu.

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

Ví dụ sau đây áp dụng cùng một cách 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 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.