Bắt đầu

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

Hãy làm theo các bước sau để thiết lập tính năng định kiểu dựa trên dữ liệu cho ranh giới.

Bật trình kết xuất bản đồ mới

Trình kết xuất bản đồ đã nâng cấp có trong phiên bản 18.0.0 của Maps SDK cho Android. Trình kết xuất này mang lại nhiều điểm cải tiến, bao gồm cả việc hỗ trợ tính năng định kiểu bản đồ dựa trên đám mây cho Maps SDK cho Android.

Khi phát hành phiên bản 18.2.0 của Maps SDK cho Android, Google đã chuyển trình kết xuất mặc định từ trình kết xuất cũ sang trình kết xuất bản đồ đã nâng cấp. Thay đổi này có nghĩa là trình kết xuất bản đồ đã nâng cấp hiện được dùng theo mặc định trong ứng dụng của bạn khi bạn tạo một ứng dụng mới hoặc tạo lại một ứng dụng hiện có.

Thận trọng: Để sử dụng tính năng định kiểu dựa trên dữ liệu cho ranh giới trong ứng dụng, bạn phải xây dựng ứng dụng bằng trình kết xuất bản đồ đã nâng cấp. Nếu bạn đang thêm tính năng định kiểu dựa trên dữ liệu cho ranh giới vào một ứng dụng hiện có, hãy nhớ tạo lại ứng dụng đó để ứng dụng sử dụng trình kết xuất bản đồ đã nâng cấp. Để biết thêm thông tin, hãy xem bài viết Trình kết xuất bản đồ mới.

Tạo mã bản đồ

Để tạo mã bản đồ mới, hãy làm theo các bước trong phần Tạo mã bản đồ. Hãy nhớ đặt Loại bản đồ thành Android.

Tạo kiểu bản đồ mới

Để tạo kiểu bản đồ mới, hãy làm theo hướng dẫn trong bài viết Quản lý kiểu bản đồ để tạo kiểu và liên kết kiểu đó với mã bản đồ mà bạn vừa tạo.

Thử nghiệm: Bạn chỉ có thể đặt tính năng này cho kiểu bản đồ sáng. Khi bạn liên kết một kiểu bản đồ sáng đã bật tính năng này với một mã bản đồ, các lớp đã bật cũng sẽ có sẵn cho kiểu bản đồ tối.

Chọn các lớp đối tượng trong kiểu bản đồ mới

Trong Google API Console, bạn có thể chọn lớp đối tượng để hiển thị cho kiểu bản đồ mới. Lớp đối tượng xác định loại ranh giới nào xuất hiện trên bản đồ (ví dụ: địa phương, tiểu bang, v.v.).

Quan trọng: Để đạt được hiệu suất tối ưu, bạn chỉ nên chọn những lớp cần thiết.

1. Trong Google API Console, hãy chuyển đến trang Kiểu bản đồ.
2. Chọn một dự án nếu được nhắc.
3. Chọn một kiểu bản đồ.
4. Nhấp vào trình đơn thả xuống Lớp đối tượng để thêm hoặc xoá lớp.
5. Nhấp vào Lưu để lưu các thay đổi và áp dụng cho bản đồ của bạn.

Cập nhật mã khởi chạy bản đồ

Bước này yêu cầu mã bản đồ mà bạn vừa tạo. Bạn có thể tìm thấy mã này trên trang Quản lý bản đồ.

Để thêm mã bản đồ vào mã khởi chạy, hãy xem phần Thêm mã bản đồ vào ứng dụng.

Truy cập vào lớp đối tượng của bản đồ

Bạn sử dụng đối tượng FeatureLayer để biểu thị từng lớp đối tượng của bản đồ, chẳng hạn như lớp đối tượng Mã bưu chính hoặc Địa phương. Để truy cập vào một đối tượng lớp đối tượng, hãy gọi GoogleMap.getFeatureLayer() khi bản đồ khởi chạy:

Java

private FeatureLayer postalCodeLayer;

@Override
public void onMapReady(GoogleMap map) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build());
  ...
}

Kotlin

private var postalCodeLayer: FeatureLayer? = null

override fun onMapReady(googleMap: GoogleMap) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = googleMap.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build())
  ...
}

Truyền một đối tượng FeatureLayerOptions đến getFeatureLayer() để chỉ định loại lớp đối tượng. Trong ví dụ này, bạn muốn truy cập vào lớp POSTAL_CODE. Tạo một đối tượng FeatureLayer khác nhau cho mỗi lớp mà bạn muốn tạo kiểu.

Sau khi có đối tượng FeatureLayer, bạn có thể áp dụng kiểu cho đa giác ranh giới trong đối tượng đó.

Lưu ý: Nếu FeatureLayer thuộc loại đã chỉ định không tồn tại cho bản đồ hoặc nếu bạn chưa bật tính năng định kiểu dựa trên dữ liệu cho ranh giới vì chưa chỉ định mã bản đồ, thì lệnh gọi này sẽ trả về nhưng ghi lại lỗi. Sử dụng phương thức FeatureLayer.isAvailable() để xác định xem FeatureLayer có sẵn hay không.

Kiểm tra các chức năng của bản đồ (bắt buộc)

Tính năng định kiểu dựa trên dữ liệu cho ranh giới yêu cầu phải có mã bản đồ. Nếu thiếu mã bản đồ hoặc mã bản đồ không hợp lệ được truyền, thì bạn không thể tải định kiểu dựa trên dữ liệu cho ranh giới. Để khắc phục sự cố, bạn có thể sử dụng MapCapabilities để kiểm tra xem tính năng định kiểu dựa trên dữ liệu cho ranh giới có được hỗ trợ hay không.

Thận trọng: Một số thiết bị có thể không hỗ trợ trình kết xuất bản đồ mới, do đó không thể hiển thị định kiểu dựa trên dữ liệu cho ranh giới. Bạn phải sử dụng MapCapabilities để kiểm tra khả năng hỗ trợ trong thời gian chạy. Nếu tính năng định kiểu dựa trên dữ liệu cho ranh giới không được hỗ trợ, hãy xác định một phương án dự phòng. Để biết các yêu cầu về thiết bị đối với trình kết xuất bản đồ mới, hãy xem phần Thiết bị được hỗ trợ.

Kotlin

val capabilities: MapCapabilities = googleMap.getMapCapabilities()
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable())

Java

MapCapabilities capabilities = googleMap.getMapCapabilities();
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable());