Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Maps JavaScript API

Untuk membantu Anda memulai, kami akan memandu Anda melalui Google Developers Console untuk melakukan beberapa hal terlebih dahulu:

  1. Buat atau pilih sebuah proyek
  2. Aktifkan Google Maps JavaScript API dan layanan terkait
  3. Buat kunci yang sesuai
Lanjutkan

Melokalkan Peta

Anda bisa menyesuaikan peta Anda untuk negara atau region tertentu dengan cara berikut:

  • Mengubah setelan bahasa default.
  • Menetapkan kode region, yang mengubah perilaku peta berdasarkan negara atau kawasan yang diberikan.

Pelokalan bahasa

Secara default, Google Maps JavaScript API menggunakan setelan bahasa pilihan pengguna seperti yang ditetapkan di browser, saat menampilkan informasi tekstual seperti nama untuk kontrol, pemberitahuan hak cipta, arah mengemudi dan label pada peta. Dalam sebagian besar kasus, sebaiknya pertimbangkan untuk mengikuti setelan browser Akan tetapi, jika Anda ingin Maps JavaScript API agar mengabaikan setelan bahasa browser, Anda bisa memaksanya untuk menampilkan informasi dalam bahasa tertentu dengan menambahkan parameter language ke tag <script> saat memuat kode Maps JavaScript API.

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

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

Tampilkan contoh.

Jika Anda menyetel bahasa peta, penting juga untuk mempertimbangkan menyetel region. 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 menyetel opsi ini.

Maps JavaScript API juga mendukung teks bi-directional (Bidi) yang berisi karakter baik dalam bahasa yang menggunakan Left-to-Right (LTR) maupun Right-to-Left (RTL) secara bawaan. Contoh bahasa RTL antara lain bahasa Arab, Ibrani dan Persia. Biasanya, Anda harus menetapkan laman bahasa RTL agar dirender secara benar dengan menambahkan dir='rtl' ke elemen <html> laman. Contoh berikut merender peta Kairo, Mesir menggunakan kontrol berbahasa Arab:

<!DOCTYPE html>
<html dir="rtl">
  <body>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&language=ar&region=EG">
    </script>
  </body>
</html>

Tampilkan contoh.

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

Pelokalan region

Bila Anda memuat Google Maps JavaScript API dari maps.googleapis.com, ini akan menerapkan kecondongan default untuk perilaku aplikasi ke Amerika Serikat. Jika ingin mengubah aplikasi agar menyajikan petak peta yang berbeda atau mencondongkan aplikasi (seperti mencondongkan hasil geocoding ke suatu region), Anda bisa mengganti perilaku default ini dengan menambahkan parameter region ke tag <script> saat memuat kode Maps JavaScript API.

Sebagai developer aplikasi Maps JavaScript API, Anda bertanggung jawab memastikan bahwa aplikasi Anda sesuai dengan undang-undang setempat dengan memastikan pelokalan region yang benar sudah diterapkan untuk negara tempat aplikasi tersebut di-host.

Parameter region menerima identifier subtag region Unicode yang (biasanya) memiliki pemetaan satu-ke-satu untuk Top-Level Domain kode negara (ccTLD). Umumnya identifier region Unicode identik dengan kode ISO 3166-1, dengan beberapa pengecualian. Misalnya, ccTLD Britania Raya adalah "uk" (sesuai dengan domain .co.uk) sementara identifier regionnya adalah "GB".

Misalnya, tag skrip berikut melokalkan peta ke Inggris Raya:

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

Contoh berikut menampilkan dua peta, satu peta membuat geocode "Toledo" berdasarkan region default (US) untuk "Toledo, Ohio" dan satu lagi membiaskan hasil berdasarkan region yang disetel ke ES (Spanyol) untuk "Toledo, Spain".

Tampilkan contoh US dan contoh ES.

Memuat API di Cina

Google Maps JavaScript API dilayani di dalam wilayah China dari http://maps.google.cn. Saat menyediakan materi ke Cina, ganti https://maps.googleapis.com dengan http://maps.google.cn. Misalnya:

<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY">
</script>

Jika Anda secara khusus menargetkan pengguna di Cina, Anda harus menambahkan parameter region dan bahasa. API mendukung zh-CN dan zh-TW sebagai nilai untuk parameter language.

<script src="http://maps.google.cn/maps/api/js?region=cn&language=zh-CN&key=YOUR_API_KEY">
</script>

Kirim masukan tentang...

Google Maps JavaScript API
Google Maps JavaScript API
Butuh bantuan? Kunjungi halaman dukungan kami.