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 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 đồ được nâng cấp có trong phiên bản 18.0.0 của Maps SDK dành cho Android. Trình kết xuất này mang đến 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 dành 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 đồ được nâng cấp. Thay đổi này có nghĩa là trình kết xuất bản đồ được 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 kiểu dựa trên dữ liệu cho ranh giới trong ứng dụng, bạn phải tạo ứng dụng bằng trình kết xuất bản đồ đã nâng cấp. Nếu bạn đang thêm 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 đảm bảo rằng bạn 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 phần 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 đồ. Đảm bảo bạn đặt Loại bản đồ thành Android.

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

Để tạo một kiểu bản đồ mới, hãy làm theo hướng dẫn trong phần 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 có bật tính năng này với một mã bản đồ, các lớp đã bật cũng 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 những lớp đối tượng cần hiển thị cho kiểu bản đồ mới. Lớp đối tượng xác định những loại ranh giới xuất hiện trên bản đồ (ví dụ: địa phương, tiểu bang, v.v.).

Lưu ý 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, 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á các lớp.
5. Nhấp vào Lưu để lưu các thay đổi và cung cấp các thay đổi đó 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 bạn phải có mã bản đồ mà bạn vừa tạo. Bạn có thể tìm thấy thông tin này trên trang Quản lý Maps.

Để 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 một lớp đối tượng của bản đồ

Bạn dùng một đố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 tạo:

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 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 các đa giác ranh giới trong đối tượng đó.

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

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

Tính năng tạo 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 bạn truyền mã bản đồ không hợp lệ, thì kiểu dựa trên dữ liệu cho ranh giới sẽ không tải được. Là một bước khắc phục sự cố, bạn có thể sử dụng MapCapabilities để kiểm tra xem tính năng tạo 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 và do đó không thể hiển thị kiểu dựa trên dữ liệu cho ranh giới. Bạn phải dùng MapCapabilities để kiểm tra chế độ hỗ trợ trong thời gian chạy. Nếu không hỗ trợ kiểu dựa trên dữ liệu cho ranh giới, hãy xác định một lựa chọn dự phòng. Để biết 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());