Konsep

Mengembangkan untuk Perangkat Seluler

Google Maps JavaScript API telah didesain untuk dimuat dengan cepat dan bekerja dengan baik pada perangkat seluler. Secara khusus, kami berfokus pada pengembangan perangkat seluler canggih seperti handset Android dan iOS. Perangkat seluler memiliki ukuran layar lebih kecil daripada browser desktop umumnya. Juga, sering kali memberikan perlakuan khusus tertentu untuk perangkat tersebut (seperti "pinch-to-zoom"). Jika ingin aplikasi Anda bekerja dengan baik pada perangkat seluler, kami menyarankan hal berikut:

Atur <div> yang berisi peta Anda untuk memiliki atribut lebar dan tinggi 100%. Akan tetapi, ketahuilah bahwa beberapa browser desktop versi lama tidak menampilkan nilai-nilai ini dengan baik.

Anda bisa mendeteksi perangkat iPhone dan Android dengan memeriksa properti navigator.userAgent dalam DOM:

function detectBrowser() {
  var useragent = navigator.userAgent;
  var mapdiv = document.getElementById("map");

  if (useragent.indexOf('iPhone') != -1 || useragent.indexOf('Android') != -1 ) {
    mapdiv.style.width = '100%';
    mapdiv.style.height = '100%';
  } else {
    mapdiv.style.width = '600px';
    mapdiv.style.height = '800px';
  }
}

Hal ini memungkinkan Anda mengubah layout untuk perangkat tertentu, seperti yang kami lakukan di sini dengan mengubah realestat layar untuk setiap perangkat.

Perangkat Android dan iOS menghormati tag <meta> berikut:
```
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
```
Pengaturan ini menetapkan bahwa peta harus ditampilkan sepenuh layar dan tidak bisa diubah ukurannya oleh pengguna. Perhatikan, browser Safari iPhone mengharuskan tag <meta> disertakan dalam elemen <head> halaman.

Untuk informasi selengkapnya tentang pengembangan untuk iPhone, lihat dokumentasi Pengembang Apple. Untuk informasi selengkapnya tentang pengembangan untuk perangkat Android, lihat dokumentasi Android.

Pelokalan

Anda bisa melokalkan aplikasi Maps API dengan mengubah pengaturan bahasa default dan dengan menetapkan kode wilayah aplikasi, yang akan mengubah bagaimana perilakunya berdasarkan negara atau wilayah yang diberikan.

Pelokalan Bahasa

Google Maps API menggunakan pengaturan bahasa pilihan browser saat menampilkan informasi tekstual seperti nama untuk kontrol, pemberitahuan hak cipta, arah mengemudi dan label pada peta. Umumnya, ini lebih disukai; Anda biasanya tidak ingin mengabaikan pengaturan bahasa pilihan pengguna. Akan tetapi, jika Anda ingin mengubah Maps API agar mengabaikan pengaturan bahasa browser dan memaksanya untuk menampilkan informasi dalam bahasa tertentu, Anda bisa menambahkan parameter language opsional ke tag <script> saat menyertakan kode Maps API JavaScript, yang menetapkan bahasa yang akan digunakan.

Misalnya, untuk menampilkan aplikasi Maps API dalam bahasa Jepang, tambahkan &language=ja ke tag <script> seperti yang ditampilkan di bawah ini:

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

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

Lihat contoh (map-language.html)

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 halaman bahasa RTL agar dirender secara benar dengan menambahkan dir='rtl' ke elemen <html> halaman. Contoh berikut merender peta Kairo, Mesir menggunakan kontrol berbahasa Arab:

Lihat contoh (map-rtl.html)

Lihat juga daftar bahasa yang didukung. Perhatikan, kami sering memperbarui bahasa yang didukung sehingga daftar ini mungkin tidak lengkap.

Pelokalan Wilayah

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

Sebagai pengembang aplikasi Maps API, Anda bertanggung jawab memastikan bahwa aplikasi Anda sesuai dengan undang-undang setempat dengan memastikan pelokalan daerah yang benar sudah diterapkan untuk negara yang menjadi tempat peredaran aplikasi tersebut.

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

Misalnya, untuk menggunakan aplikasi Maps API yang dilokalkan ke Inggris, tambahkan &region=GB ke tag <script> seperti yang ditampilkan di bawah ini:

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

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

Memuat API di Cina

Google Maps API disediakan di Cina dari http://maps.google.cn. Saat menyediakan konten 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"
type="text/javascript">
</script>

Jika Anda secara khusus menargetkan pengguna di Cina, Anda juga mungkin perlu menambahkan parameter wilayah 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"
type="text/javascript">
</script>

Penetapan Versi

Tim Google Maps JavaScript API secara teratur memperbarui API dengan fitur baru, perbaikan bug, dan peningkatan kinerja. Anda bisa menunjukkan versi API yang dimuat dalam aplikasi dengan menetapkannya dalam parameter v permintaan bootstrap Google Maps JavaScript API. Baca selengkapnya tentang penetapan versi.