Parameter URL Maps JavaScript API

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

Dokumen ini membahas semua parameter yang dapat Anda tentukan dalam string kueri URL pemuatan skrip saat memuat Maps JavaScript API. Beberapa parameter tertentu diperlukan sementara yang lainnya bersifat opsional. Sebagaimana standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&).

Contoh URL berikut memiliki placeholder untuk semua kemungkinan parameter:

https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY
&callback=FUNCTION_NAME
&v=VERSION
&libraries="LIBRARIES"
&language="LANGUAGE"
&region="REGION"
&solution_channel="SOLUTION_IDENTIFIER"
&auth_referrer_policy="AUTH_REFERRER_POLICY"

URL dalam contoh tag script berikut memuat Maps JavaScript API:

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

Parameter yang diperlukan

Parameter berikut diperlukan saat memuat Maps JavaScript API.

  • key: Kunci API Anda. Maps JavaScript API tidak akan dimuat kecuali jika kunci API yang valid ditentukan.

  • callback: Nama fungsi global yang akan dipanggil setelah Maps JavaScript API dimuat sepenuhnya.

Parameter opsional

Gunakan parameter ini untuk meminta versi tertentu Maps JavaScript API, memuat library tambahan, melokalkan peta Anda, atau menentukan kebijakan pemeriksaan perujuk HTTP

  • v: Versi Maps JavaScript API yang akan digunakan.

  • libraries: Daftar yang dipisahkan koma untuk library Maps JavaScript API tambahan yang akan dimuat.

  • language: Bahasa yang akan digunakan. Hal ini memengaruhi nama kontrol, pemberitahuan hak cipta, rute mobil, dan label kontrol, serta respons atas permintaan layanan. Lihat daftar bahasa yang didukung.

  • region: Kode wilayah yang akan digunakan. Parameter ini akan mengubah perilaku peta berdasarkan negara atau wilayah yang tertentu.

  • solution_channel: Google Maps Platform menyediakan banyak jenis kode contoh untuk membantu Anda memulai dan menjalankan dengan cepat. Untuk melacak penerapan contoh kode yang lebih kompleks dan meningkatkan kualitas solusi, Google menyertakan parameter kueri solution_channel dalam panggilan API di kode contoh kita.

  • auth_referrer_policy: Pelanggan Maps JS dapat mengonfigurasi Pembatasan Perujuk HTTP di Cloud Console untuk membatasi URL mana yang diizinkan untuk menggunakan Kunci API tertentu. Secara default, pembatasan ini dapat dikonfigurasi untuk mengizinkan hanya jalur tertentu yang menggunakan sebuah Kunci API. Jika URL di domain atau asal yang sama dapat menggunakan Kunci API tersebut, Anda dapat menetapkan auth_referrer_policy=origin untuk membatasi jumlah data yang dikirim saat mengizinkan permintaan dari Maps JavaScript API. Fitur ini tersedia mulai versi 3.46. Jika parameter ini ditentukan dan Pembatasan Perujuk HTTP diaktifkan di Cloud Console, Maps JavaScript API hanya dapat dimuat jika ada Pembatasan Perujuk HTTP yang cocok dengan domain situs saat ini tanpa jalur yang ditentukan.