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:
Mendapatkan instance ConsumerApi
Untuk menggunakan Consumer SDK, aplikasi Anda harus melakukan inisialisasi 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 informasi selengkapnya tentang cara membuat project Fleet Engine, lihat Membuat project Fleet Engine di panduan Fleet Engine.
Aplikasi Anda harus mengimplementasikan 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 berdasarkan versi Maps SDK
dan dukungan kedua perender. Jika memungkinkan, gunakan perender terbaru.
Jika Anda harus menggunakan perender lama, tentukan secara eksplisit menggunakan
MapsInitializer.initialize().
| Versi Maps SDK | 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 Maps 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:
Meng-inflate tampilan yang berisi
GoogleMapViewatauConsumerMapView.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.
Melakukan inisialisasi Maps SDK sebelum melakukan inisialisasi Consumer SDK
Di class
ApplicationatauActivitystartup, panggil MapsInitializer.initialize()Tunggu hasil permintaan perender sebelum melakukan inisialisasi 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, implementasi Consumer SDK menggunakan SSL/TLS untuk berkomunikasi dengan 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 penggunaan SSL di Android, lihat Penyedia GMS
Keamanan.
Artikel ini juga berisi contoh kode untuk melakukan patch pada penyedia keamanan.