Panduan memulai Maps Embed API

Tempatkan peta interaktif atau panorama Street View di halaman web Anda dengan permintaan HTTP—tidak memerlukan JavaScript kustom.

Biaya

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

Sebelum memulai

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

Langkah 1: Siapkan project Anda

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. 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: Aktifkan API atau SDK

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: Mendapatkan kunci API

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 baru atau menambahkan API atau SDK ke kunci yang ada, ikuti petunjuk berikut.

Konsol

  1. Buka halaman Google Maps Platform > Keys & Credentials.

    Buka halaman Keys & Credentials

  2. Jika diminta, pilih project Anda.

  3. Lakukan salah satu hal berikut:

    • Buat kunci baru:

      1. Klik Create credentials > API key.
      2. Di panel Buat kunci API, buka daftar Pilih batasan API.
      3. Hapus API yang tidak diperlukan oleh kunci ini, dan pastikan Maps Embed API tetap dipilih.
      4. Klik Buat. Panel akan menampilkan kunci API baru Anda.

    • Menggunakan kunci yang ada:

      1. Klik nama kunci.
      2. Dalam daftar Select API restrictions, pilih Maps Embed API.
      3. Klik Simpan.

    Memilih API di sini tidak akan mengaktifkannya. Pastikan Maps Embed API diaktifkan di halaman Library API.

  4. Untuk melihat string kunci nanti, buka halaman Keys & Credentials, lalu klik Show key untuk kunci tersebut.

Jika konsol terlihat berbeda dari langkah-langkah ini, lihat Membuat kunci API dan Menambahkan pembatasan API dalam dokumentasi Google Cloud.

Cloud SDK

Ganti PROJECT_ID dengan project ID Anda dalam perintah berikut.

  • Buat kunci baru: Jalankan perintah berikut, dan ganti DISPLAY_NAME dengan nama untuk kunci. 

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=maps-embed-backend.googleapis.com

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

  • Gunakan kunci yang ada: Jalankan perintah berikut, dan ganti KEY_ID dengan ID kunci. Flag --append mempertahankan API yang sudah diizinkan oleh kunci. Tanpa parameter ini, perintah akan menggantinya.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=maps-embed-backend.googleapis.com

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

    ID kunci bukanlah string kunci atau nama tampilan. Untuk menemukannya, jalankan gcloud services api-keys list --project="PROJECT_ID". ID adalah bagian terakhir dari kolom name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Untuk melihat string kunci, jalankan gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

Membuat iframe

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

Menguji iframe Anda

Untuk melihat iframe di jendela browser HTML:

  1. Buka editor teks default Anda. Anda seharusnya sudah menginstal editor teks seperti TextEdit atau Microsoft Windows Notepad di perangkat Anda 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 hampir semua sistem operasi.

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

Pembersihan

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

  1. Di konsol Google Cloud, buka halaman Kelola 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 Delete.
  4. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Langkah berikutnya