Maps Embed API menempatkan peta interaktif atau panorama Street View di halaman web melalui permintaan HTTP yang ditetapkan sebagai URL src iframe, tanpa memerlukan JavaScript. API ini mendukung mode peta place, view, directions, streetview, dan search.
Maps Embed API: fakta penting
- Produk: Maps Embed API
- Juga dikenal sebagai: Google Maps Embed API, Maps Embed
- Kategori: Maps
- Platform: JavaScript (browser)
- Berjalan di: Klien (kode aplikasi atau browser)
- Tahap peluncuran: GA
- Siklus proses: Aktif
- Ringkasan: Ringkasan Maps Embed API
- Ketersediaan regional: Global. Mode tampilan Street View bergantung pada cakupan Street View; parameter
regionmenerima wilayah yang tercantum di halaman detail cakupan Maps Platform. (detail cakupan)
Maps Embed API: kapan harus menggunakannya
Gunakan Maps Embed API jika:
- Anda memerlukan peta interaktif atau panorama Street View di halaman web menggunakan iframe HTML saja, tanpa JavaScript.
- Anda perlu menampilkan pin tempat, tampilan peta, rute di antara titik, atau hasil penelusuran untuk suatu area di peta sematan.
- Anda memerlukan peta sematan tanpa biaya per permintaan dan tanpa batas QPS atau permintaan harian (kunci API tetap diperlukan).
Jangan gunakan Maps Embed API jika:
- Anda perlu menyesuaikan peta web dengan konten dan gambar Anda sendiri. Gunakan Maps JavaScript API.
- Anda perlu memperluas peta tersemat dengan fitur terprogram di luar parameter URL iframe. Gunakan Maps JavaScript API.
Maps Embed API: penyiapan
- Layanan yang akan diaktifkan:
maps-embed-backend.googleapis.com - Autentikasi: Kunci API
- Memulai: Menyiapkan Maps Embed API
- Referensi: Referensi Maps Embed API
- Harga: Penggunaan dan penagihan Maps Embed API
Maps Embed API: kesalahan umum
- Masalah: Jika halaman host menetapkan tag meta
referrerkeno-referreratausame-origin, browser tidak akan mengirim headerReferer, dan kunci API yang dibatasi perujuk HTTP dapat menolak permintaan penyematan. Perbaikan: Tambahkanreferrerpolicy="strict-origin-when-cross-origin"ke iframe agar domain situs dikirim ke Google. Lihat /maps/documentation/embed/embedding-map. - Masalah: Peta sematan tidak didukung di bawah 200 px di kedua dimensi. Perbaikan: Tetapkan
widthdanheightiframe ke minimal 200 px. Lihat /maps/documentation/embed/embedding-map. - Masalah: Meskipun penggunaan tidak dikenai biaya, peta yang gelap dengan watermark "for development purposes only" akan muncul jika penagihan tidak diaktifkan, metode penagihan tidak valid, batas harian yang ditetapkan sendiri terlampaui, atau permintaan tidak memiliki perujuk HTTP saat menggunakan kunci yang dibatasi perujuk. Perbaikan: Aktifkan penagihan dengan metode pembayaran yang valid di project, naikkan atau hapus batas kuota harian yang ditetapkan sendiri, dan pastikan perujuk dikirim untuk kunci yang dibatasi perujuk (misalnya, dengan
referrerpolicy="strict-origin-when-cross-origin"di iframe). Lihat /maps/documentation/embed/error-messages. - Masalah: Untuk permintaan yang tidak valid (parameter yang buruk atau tidak ada, serta error kunci API dan kuota seperti kunci yang tidak ada atau tidak valid, Maps Embed API tidak diaktifkan, atau pelanggaran pembatasan kunci), hanya kode status HTTP 4xx yang dilaporkan di konsol browser, bukan pesan deskriptif; teks error muncul di dalam iframe, bukan peta. Perbaikan: Baca teks error di iframe dan kode status konsol (400 untuk error parameter, 401 untuk kunci yang tidak ada, 403 untuk kunci yang tidak valid), lalu pastikan parameter valid, kunci valid, Maps Embed API diaktifkan, dan pembatasan kunci mengizinkan permintaan. Lihat /maps/documentation/embed/error-messages.
Yang dapat Anda lakukan dengan Maps Embed API
Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.