Melakukan inisialisasi Consumer SDK

Sebelum memulai prosedur ini, pastikan Anda telah mengaktifkan layanan yang sesuai dan Consumer SDK seperti yang dijelaskan di bagian sebelumnya.

Untuk melakukan inisialisasi Consumer SDK, ikuti langkah-langkah berikut:

  1. Dapatkan instance ConsumerAPI
  2. Menginisialisasi Maps SDK untuk meminta perender pilihan

Mendapatkan instance ConsumerApi

Untuk menggunakan Consumer SDK, aplikasi Anda perlu menginisialisasi singleton ConsumerApi secara asinkron. Metode inisialisasi menggunakan class AuthTokenFactory untuk membuat token JWT baru bagi pengguna jika diperlukan.

providerId adalah Project ID Project Google Cloud Anda. Untuk mengetahui informasi selengkapnya tentang cara membuat project Fleet Engine, lihat Membuat project Fleet Engine di panduan Fleet Engine.

Aplikasi Anda harus menerapkan AuthTokenFactory seperti yang dijelaskan dalam Autentikasi Consumer SDK.

Java

Task<ConsumerApi> consumerApiTask = ConsumerApi.initialize(
    this, "myProviderId", authTokenFactory);

consumerApiTask.addOnSuccessListener(
  consumerApi -> this.consumerApi = consumerApi);

Kotlin

val consumerApiTask =
  ConsumerApi.initialize(this, "myProviderId", authTokenFactory)

consumerApiTask?.addOnSuccessListener { consumerApi: ConsumerApi ->
  this@YourActivity.consumerApi = consumerApi
}

Maps SDK dan perender peta

Consumer SDK v2.0.0 dan yang lebih baru mendukung Maps SDK for Android v18.1.0 dan yang lebih baru. Tabel berikut merangkum perender default menurut versi Maps SDK dan kemampuan dukungan kedua perender. Jika memungkinkan, gunakan perender terbaru. Jika Anda harus menggunakan perender lama, tentukan secara eksplisit menggunakan MapsInitializer.initialize().

Versi SDK Maps Mendukung perender terbaru Mendukung perender lama Perender default
V18.1.0 dan yang lebih lama Ya Ya Lama*
V18.2.0 Ya Ya Terbaru

* Dengan peluncuran Perender Peta baru, perender Terbaru akan menjadi default.

Jika Anda harus menggunakan perender pilihan, jalankan semua operasi rendering UI setelah OnMapsSdkInitializedCallback menampilkan hasil. Operasi rendering UI mencakup operasi berikut:

  • Meluaskan tampilan yang berisi GoogleMapView atau ConsumerMapView.

  • Menempatkan penanda di ConsumerMapView.

Jika Anda tidak menjalankan operasi ini setelah menerima hasil OnMapsSdkInitializedCallback, Maps SDK tidak akan mengalokasikan perender pilihan Anda dan tampilan peta akan dirender oleh perender default.

Lakukan inisialisasi Maps SDK sebelum melakukan inisialisasi Consumer SDK

  1. Di class Application atau Activity saat memulai, panggil MapsInitializer.initialize()

  2. Tunggu hasil permintaan perender sebelum menginisialisasi Consumer SDK.

Lihat contoh berikut untuk mengetahui detailnya.

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.main);
  initViews();

  MapsInitializer.initialize(getApplicationContext(), Renderer.LATEST,
      new OnMapsSdkInitializedCallback() {
        @Override
        public void onMapsSdkInitialized(Renderer renderer) {
          switch (renderer) {
            case LATEST:
              Log.i("maps_renderer", "LATEST renderer");
              break;
            case LEGACY:
              Log.i("maps_renderer", "LEGACY renderer");
              break;
          }

          initializeConsumerSdk();
        }
      });
}

Kotlin

fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.main)
  initViews()

  MapsInitializer.initialize(
    getApplicationContext(), Renderer.LATEST,
    object : OnMapsSdkInitializedCallback() {
      fun onMapsSdkInitialized(renderer: Renderer?) {
        when (renderer) {
          LATEST -> Log.i("maps_renderer", "LATEST renderer")
          LEGACY -> Log.i("maps_renderer", "LEGACY renderer")
        }
        initializeConsumerSdk()
      }
    })
  }

Catatan tentang SSL/TLS

Secara internal, penerapan Consumer SDK menggunakan SSL/TLS untuk berkomunikasi secara aman dengan layanan Fleet Engine. Android API versi 23 atau yang lebih lama mungkin memerlukan patch SecurityProvider untuk berkomunikasi dengan server. Untuk mengetahui informasi selengkapnya tentang cara menggunakan SSL di Android, lihat Penyedia GMS Keamanan. Artikel ini juga berisi contoh kode untuk melakukan patching pada penyedia keamanan.

Langkah berikutnya

Menyiapkan peta