Melokalkan peta

Anda dapat menyesuaikan setelan bahasa dan wilayah yang digunakan di peta dengan mengubah setelan bahasa default dan kode wilayah peta, yang dapat memengaruhi perilaku peta berdasarkan negara atau wilayah yang ditentukan.

Lihat cakupan Maps 3D SDK for Android di tabel cakupan Maps.

Pelokalan bahasa

Secara default, Maps 3D SDK for Android menggunakan setelan bahasa yang dikonfigurasi di perangkat pengguna untuk menentukan terjemahan peta yang akan ditampilkan. Namun, Anda dapat mengganti perilaku default ini dan menetapkan bahasa tertentu saat melakukan inisialisasi peta, atau memperbarui bahasa dan wilayah secara dinamis setelah peta diinisialisasi.

Menyetel bahasa akan memengaruhi bahasa yang digunakan untuk menampilkan kontrol UI, tooltip, dan pemberitahuan hak cipta. Update lokalitas runtime ditampilkan dalam tampilan peta, tetapi tidak pada kontrol UI, tooltip, atau elemen lainnya. Hal ini juga memengaruhi terjemahan fitur politik, deskriptor, dan fitur alami—seperti mengubah "Geneva" menjadi "Genève" atau "lake" menjadi "lac"—dan mengubah arah teks yang dirender untuk skrip kanan ke kiri.

Maps 3D SDK for Android mencari preferensi pelokalan dalam urutan berikut. Jika preferensi tidak ditentukan pada langkah pertama, preferensi akan terus mencari dalam urutan yang ditentukan:

  1. Update runtime: Preferensi bahasa dan wilayah yang diteruskan ke setLocale pada instance GoogleMap3D Anda menggunakan LocaleOptions.
  2. Inisialisasi peta: Preferensi bahasa dan wilayah yang ditentukan saat membuat peta, baik di XML tata letak Anda di Map3DView menggunakan atribut map3d:language dan map3d:region, atau secara terprogram menggunakan Map3DInitConfig.
  3. Setelan perangkat: Lokalitas default sistem yang dikonfigurasi di perangkat Android.

Contoh berikut menampilkan peta dalam bahasa China ("zh") dan menetapkan wilayah ke China ("CN").

Anda dapat mengonfigurasi bahasa dan wilayah dalam file XML tata letak menggunakan atribut map3d:language dan map3d:region pada Map3DView:

<com.google.android.gms.maps3d.Map3DView
    android:id="@+id/map3dView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    map3d:mapMode="hybrid"
    map3d:language="zh"
    map3d:region="CN" />

Anda juga dapat memperbarui bahasa dan wilayah secara dinamis saat runtime dengan membuat instance LocaleOptions, menetapkan nilai dengan setLanguage dan setRegion, serta meneruskannya ke setLocale di instance GoogleMap3D:

val localeOptions = LocaleOptions().apply {
    language = "zh"
    region = "CN"
}
googleMap3D.setLocale(localeOptions)

Pelokalan wilayah

Menetapkan wilayah menggunakan atribut XML map3d:region, properti region di Map3DInitConfig, atau setRegion di LocaleOptions dapat menampilkan ubin peta yang berbeda atau mengarahkan aplikasi ke hasil yang lebih sesuai secara regional. Selain itu, menyetel tag wilayah memastikan bahwa aplikasi mematuhi hukum setempat dengan menerapkan pelokalan regional yang benar untuk negara atau wilayah tempat aplikasi didistribusikan.