Melokalkan Peta

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

  • Mengubah setelan bahasa default.
  • Menetapkan 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. Dalam sebagian besar kasus, sebaiknya pertimbangkan untuk mengikuti 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 <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, saat melakukan geocoding pada alamat tingkat jalan, nama negara akan ditampilkan dalam bahasa yang Anda minta, tetapi alamat lainnya akan spesifik untuk lokasi yang Anda proses geocoding-nya. 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 wilayah ke Jepang:

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

Lihat contoh.

Jika Anda menetapkan bahasa peta, sebaiknya pertimbangkan juga penetapan wilayah. Cara ini membantu memastikan aplikasi Anda mematuhi hukum setempat.

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

Maps JavaScript API juga mendukung teks dua arah (Bidi) yang berisi karakter baik dalam bahasa yang menggunakan sistem Left-to-Right (LTR) maupun Right-to-Left (RTL) secara native. Contoh bahasa RTL antara lain 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&loading=async&region=EG&language=ar&callback=initMap">
</script>

Lihat contoh

Lihat daftar bahasa yang didukung. Perhatikan, bahasa baru sering ditambahkan, sehingga daftar ini tidak selalu lengkap.

Pelokalan wilayah

Tambahkan parameter region ke tag <script> saat memuat kode Maps JavaScript API, jika Anda ingin mengubah aplikasi agar menampilkan ubin peta yang berbeda atau mengarahkan aplikasi (seperti mengarahkan 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 aplikasi Anda mematuhi hukum setempat dengan memastikan pelokalan wilayah yang benar telah diterapkan untuk negara tempat aplikasi tersebut dihosting.

Parameter region menerima ID subtag wilayah Unicode yang (umumnya) memiliki pemetaan one-to-one untuk Domain Level Teratas kode negara (ccTLD). Sebagian besar ID wilayah Unicode identik dengan kode ISO 3166-1 alpha-2, dengan beberapa pengecualian. Misalnya, ccTLD Great Britain adalah "uk" (sesuai dengan domain .co.uk) sedangkan ID wilayahnya 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&loading=async&region=GB&callback=initMap">
</script>

Contoh berikut menampilkan dua peta, satu peta yang melakukan geocoding "Toledo" berdasarkan region yang ditetapkan ke US (AS) untuk "Toledo, Ohio" dan satu lagi yang mengarahkan hasil berdasarkan region yang ditetapkan ke ES (Spanyol) untuk "Toledo, Spain."

Lihat contoh US dan contoh ES.

Demo Pelokalan

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

Lihat demo ini dalam layar penuh.