Panduan memulai Maps Embed API

Tempatkan peta interaktif, atau panorama Street View di halaman web Anda dengan permintaan HTTP sederhana—tanpa memerlukan JavaScript.

Biaya

Semua permintaan Maps Embed API tersedia tanpa biaya dengan penggunaan tidak terbatas. Namun, semua permintaan masih memerlukan kunci Google Cloud API yang valid. Untuk informasi selengkapnya, lihat Penggunaan dan Penagihan.

Sebelum memulai

Untuk membuat peta tersemat di halaman web, selesaikan langkah-langkah penyiapan yang diperlukan dengan mengklik tab berikut:

Langkah 1

Konsol

  1. Di Konsol Google Cloud, pada halaman pemilih project, klik Create Project untuk mulai membuat project Cloud baru.

    Buka halaman pemilih project

  2. Pastikan penagihan diaktifkan untuk project Cloud Anda. Konfirmasikan bahwa penagihan diaktifkan untuk project Anda.

    Google Cloud menawarkan uji coba tanpa biaya. Masa uji coba berakhir setelah 90 hari atau setelah akumulasi tagihan akun mencapai $300, mana saja yang lebih dulu. Batalkan kapan saja. Google Maps Platform memberikan kredit bulanan berulang sebesar $200. Untuk informasi selengkapnya, lihat Kredit akun penagihan dan Penagihan.

Cloud SDK

gcloud projects create "PROJECT"

Baca selengkapnya tentang Google Cloud SDK, Penginstalan Cloud SDK, dan perintah berikut:

Langkah 2

Untuk menggunakan Google Maps Platform, Anda harus mengaktifkan API atau SDK yang akan digunakan dengan project.

Konsol

Mengaktifkan Maps Embed API

Cloud SDK

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

Baca selengkapnya tentang Google Cloud SDK, Penginstalan Cloud SDK, dan perintah berikut:

Langkah 3

Langkah ini hanya ada di proses pembuatan Kunci API. Jika Anda menggunakan Kunci API dalam produksi, kami sangat menyarankan agar Anda membatasi kunci API. Anda dapat menemukan informasi selengkapnya di halaman Menggunakan Kunci API spesifik per produk.

Kunci API adalah ID unik yang mengautentikasi permintaan terkait project untuk tujuan penggunaan dan penagihan. Anda harus memiliki setidaknya satu kunci API terkait project.

Untuk membuat kunci API:

Konsol

  1. Buka halaman Google Maps Platform > Credentials.

    Buka halaman Credentials

  2. Pada halaman Credentials, klik Create credentials > API key.
    Dialog API key created akan menampilkan kunci API yang baru dibuat.
  3. Klik Close.
    Kunci API baru dicantumkan pada halaman Credentials di bawah API keys.
    (Jangan lupa untuk membatasi kunci API sebelum menggunakannya dalam produksi.)

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Baca selengkapnya tentang Google Cloud SDK, Penginstalan Cloud SDK, dan perintah berikut:

Membuat iframe

Klik opsi berikut dan tambahkan lokasi serta kunci API untuk membuat iframe untuk halaman web Anda. Untuk parameter dan opsi tambahan, lihat Menyertakan peta.

Menguji iframe

Untuk melihat iframe di jendela browser HTML:

  1. Buka editor teks default Anda. Anda harus menginstal editor teks seperti TextEdit atau Microsoft Windows Notepad di perangkat secara default.
  2. Buat file HTML dan beri nama index.html.
  3. Tambahkan kode berikut dengan iframe yang Anda buat di atas:

    <html>
      <!-- Replace this code comment with your iframe. -->
    </html>
    
  4. Simpan file HTML index.html Anda.

  5. Muat file HTML di browser web dengan menariknya dari desktop ke browser Anda; atau, mengklik dua kali pada file juga dapat digunakan pada sebagian besar sistem operasi.

Selamat! Anda baru saja menyiapkan dan membuat peta menggunakan Maps Embed API.

Pembersihan

Anda dapat menghapus project Google Cloud untuk menghentikan penagihan atas semua resource yang digunakan dalam project tersebut.

  1. Di Konsol Google Cloud, buka halaman Mengelola resource:

    Buka halaman Kelola resource

  2. Jika project yang ingin Anda hapus tertaut ke organisasi, pilih dan luaskan daftar organisasi di bagian atas halaman.
  3. Dalam daftar project, pilih project yang ingin Anda hapus, lalu klik Hapus.
  4. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Langkah berikutnya