Trình kết xuất bản đồ mới

Trình kết xuất bản đồ đã nâng cấp có sẵn kể từ phiên bản 18.2.0 của SDK bản đồ 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ợ định kiểu bản đồ trên đám mây.

Trình kết xuất mới mang lại các lợi ích sau:

  • Các tính năng tạo kiểu bản đồ trên đám mây hiện đã có trong trình kết xuất mới.
  • Bạn có thể sử dụng Tuỳ chỉnh nhiều đường nâng cao cùng với trình kết xuất mới.
  • Giảm tải mạng, nhu cầu xử lý và mức tiêu thụ bộ nhớ.
  • Cải thiện khả năng xử lý cử chỉ để mang lại ảnh động tốt hơn, cùng với tính năng kéo và thu phóng mượt mà hơn.
  • Chuyển đổi linh hoạt hơn và nhãn bản đồ được định vị rõ ràng.
  • Mang đến trải nghiệm người dùng ổn định và tốt hơn.

Lịch phát hành

Tháng 3 năm 2024, Google bắt đầu tự động cập nhật tất cả ứng dụng đã triển khai trên một thiết bị để sử dụng trình kết xuất đã nâng cấp. Tính năng tự động cập nhật sẽ tăng dần trong những tháng tới dựa trên thiết bị, nghĩa là thiết bị của người dùng cuối sẽ được cập nhật vào những thời điểm khác nhau trong khoảng thời gian cập nhật.

Các bản cập nhật tự động áp dụng cho tất cả ứng dụng chạy trên thiết bị đáp ứng các yêu cầu tối thiểu về thiết bị, bất kể phiên bản SDK Maps dành cho Android mà ứng dụng sử dụng.

Các bản cập nhật tự động này không áp dụng cho:

Điều gì xảy ra khi trình kết xuất đồ hoạ mặc định thay đổi?

Trình kết xuất mặc định đã trở thành trình kết xuất được nâng cấp với bản phát hành phiên bản 18.2.0 của SDK Maps dành cho Android. Để tận dụng trình kết xuất đã nâng cấp, bạn có thể tạo ứng dụng mới hoặc tạo lại mọi ứng dụng hiện có bằng cách sử dụng phiên bản SDK mới. Hoặc bạn có thể đợi cho đến khi Google tự động cập nhật ứng dụng đã triển khai của bạn.

Sau khi cập nhật, ứng dụng của bạn có thể tận dụng tất cả tính năng và lợi ích mới có trong trình kết xuất đã nâng cấp.

Tuy nhiên, nếu bạn quyết định chọn không áp dụng thay đổi này, ứng dụng của bạn sẽ tiếp tục sử dụng trình kết xuất cũ. Xem phần Chọn không sử dụng trình kết xuất đồ hoạ nâng cấp để tham khảo mã ví dụ về cách chọn không sử dụng.

Thiết bị được hỗ trợ

Tính năng tự động cập nhật áp dụng cho mọi thiết bị đáp ứng các tiêu chí này, bất kể phiên bản SDK bản đồ dành cho Android mà ứng dụng sử dụng:

  • Android 5.0 (API cấp 21) trở lên
  • Sử dụng Dịch vụ Google Play phiên bản 21.39.14 trở lên

Các thiết bị chạy Android 4.4W (API cấp 20) trở xuống hoặc sử dụng Dịch vụ Google Play phiên bản 21.39.13 trở xuống tiếp tục sử dụng trình kết xuất cũ.

Chọn không sử dụng trình kết xuất đã nâng cấp

Nếu cần, bạn có thể chọn không sử dụng trình kết xuất đã nâng cấp một cách rõ ràng để sử dụng trình kết xuất cũ trong ứng dụng của mình.

Cách làm như sau:

Mã của bạn phải gọi MapsInitializer.initialize() trước khi bất kỳ MapView, MapFragment hoặc SupportMapFragment nào được tạo. Bạn nên gọi lệnh này trong onCreate cho Ứng dụng hoặc Hoạt động của ứng dụng trước khi đặt khung hiển thị nội dung.

Ví dụ sau cho thấy cách gọi MapsInitializer.initialize() để chọn không sử dụng trình kết xuất bản đồ cũ.

Kotlin

import com.google.android.gms.maps.MapsInitializer
import com.google.android.gms.maps.MapsInitializer.Renderer
import com.google.android.gms.maps.OnMapsSdkInitializedCallback

internal class MapRendererOptInApplication : Application(), OnMapsSdkInitializedCallback {
  override fun onCreate() {
    super.onCreate()
    MapsInitializer.initialize(applicationContext, Renderer.LEGACY, this)
  }

  override fun onMapsSdkInitialized(renderer: MapsInitializer.Renderer) {
    when (renderer) {
      Renderer.LATEST -> Log.d("MapsDemo", "The latest version of the renderer is used.")
      Renderer.LEGACY -> Log.d("MapsDemo", "The legacy version of the renderer is used.")
    }
  }
}

Java

import com.google.android.gms.maps.MapsInitializer;
import com.google.android.gms.maps.MapsInitializer.Renderer;
import com.google.android.gms.maps.OnMapsSdkInitializedCallback;

class MapRendererOptInApplication extends Application implements OnMapsSdkInitializedCallback {

  @Override
  public void onCreate() {
    super.onCreate();
    MapsInitializer.initialize(getApplicationContext(), Renderer.LEGACY, this);
  }

  @Override
  public void onMapsSdkInitialized(MapsInitializer.Renderer renderer) {
    switch (renderer) {
      case LATEST:
        Log.d("MapsDemo", "The latest version of the renderer is used.");
        break;
      case LEGACY:
        Log.d("MapsDemo", "The legacy version of the renderer is used.");
        break;
    }
  }
}