Melokalkan Peta

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Anda dapat menyesuaikan peta untuk negara atau wilayah tertentu dengan cara berikut:

  • Mengubah setelan bahasa default.
  • Tentukan kode wilayah, yang mengubah perilaku peta berdasarkan negara atau wilayah yang diberikan.

Pelokalan bahasa

Secara default, Maps JavaScript API menggunakan setelan bahasa pilihan pengguna seperti yang ditentukan di browser, saat menampilkan informasi tekstual seperti nama untuk kontrol, pemberitahuan hak cipta, rute mobil, dan label di peta. Pada umumnya, lebih baik mematuhi setelan browser. Namun, jika Anda ingin Maps JavaScript API mengabaikan setelan bahasa browser, Anda dapat memaksanya untuk menampilkan informasi dalam bahasa tertentu dengan menambahkan parameter language ke tag <script> saat memuat kode Maps JavaScript API.

Parameter language memengaruhi nama kontrol, pemberitahuan hak cipta, rute mobil, dan label kontrol, serta respons terhadap permintaan layanan. Pengaruh terhadap layanan tidak terlalu jelas. Misalnya, jika geocoding alamat tingkat jalan, nama negara akan ditampilkan dalam bahasa yang Anda minta, tetapi alamat lainnya akan spesifik untuk lokasi yang Anda geocoding. Di sisi lain, hasil pos dan politik ditampilkan dalam bahasa yang diminta. Coba demo ini untuk bereksperimen dengan perubahan pada peta saat Anda memperbarui parameter language.

Contoh berikut menampilkan peta dalam bahasa Jepang dan menetapkan region ke Jepang:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&region=JP&language=ja&callback=initMap">
</script>

Lihat contoh.

Jika Anda menetapkan bahasa peta, penting juga untuk mempertimbangkan untuk menyetel region. Tindakan ini membantu memastikan bahwa aplikasi Anda mematuhi hukum setempat.

Catatan: Saat Anda memuat API dengan cara yang ditampilkan di atas, peta akan menggunakan bahasa Jepang untuk semua pengguna terlepas dari preferensi pengguna. Pastikan Anda menginginkan perilaku ini sebelum menyetel opsi ini.

Maps JavaScript API juga mendukung teks dua arah (Bidi) yang berisi karakter baik dalam bahasa yang menggunakan pendekatan kiri-ke-kanan (LTR) maupun kanan-ke-kiri (RTL). Contoh bahasa RTL mencakup bahasa Arab, Ibrani, dan Persia. Umumnya, Anda harus menentukan halaman bahasa RTL agar dirender dengan benar dengan menambahkan dir='rtl' ke elemen <html> halaman. Contoh berikut merender peta Kairo, Mesir menggunakan kontrol berbahasa Arab:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&region=EG&language=ar&callback=initMap">
</script>

Lihat contoh

Lihat daftar bahasa yang didukung. Perlu diperhatikan bahwa bahasa baru sering ditambahkan, sehingga daftar ini mungkin tidak lengkap.

Pelokalan region

Tambahkan parameter region ke tag <script> saat memuat kode Maps JavaScript API, jika Anda ingin mengubah aplikasi untuk menampilkan ubin peta yang berbeda atau mencondongkan aplikasi (seperti mencondongkan hasil geocoding ke suatu wilayah).

Sebagai developer aplikasi Maps JavaScript API, Anda disarankan untuk selalu menetapkan parameter region karena berbagai layanan (seperti Places Autocomplete) cenderung memberikan hasil yang lebih baik saat region ditetapkan. Anda juga bertanggung jawab untuk memastikan bahwa aplikasi Anda mematuhi hukum setempat dengan memastikan bahwa pelokalan region yang benar diterapkan untuk negara tempat aplikasi dihosting.

Parameter region menerima ID subtag region Unicode yang (umumnya) memiliki pemetaan one-to-one untuk Domain Level Teratas (ccTLD) kode negara. Sebagian besar ID region Unicode identik dengan kode ISO 3166-1 alpha-2, dengan beberapa pengecualian yang penting. Misalnya, ccTLD Britania Raya adalah "uk" (sesuai dengan domain .co.uk) sementara ID regionnya adalah "GB." Lihat Detail Cakupan Google Maps Platform untuk wilayah yang didukung. Coba demo ini untuk bereksperimen dengan perubahan pada peta saat Anda memperbarui parameter region.

Misalnya, tag skrip berikut melokalkan peta ke Inggris Raya:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&region=GB&callback=initMap">
</script>

Contoh berikut menunjukkan dua peta, satu peta yang melakukan geocoding "Toledo" berdasarkan region yang ditetapkan ke US (AS) ke "Toledo, Ohio" dan satu yang mencondongkan hasil berdasarkan region yang ditetapkan ke ES (Spanyol) ke "Toledo, Spanyol."

Lihat contoh AS dan contoh ES.

Demo Pelokalan

Saat menyetel bahasa peta, penting juga untuk mempertimbangkan menyetel wilayah. Berikut adalah demo yang memungkinkan Anda memuat peta dengan pilihan bahasa dan wilayah.

Lihat demo ini dalam layar penuh.