Menyiapkan Maps Static API

Dokumen ini menjelaskan langkah-langkah yang Anda perlukan untuk mulai menggunakan Maps Static API.

Prasyarat

Prosedur ini memandu Anda menyiapkan Akun Google Cloud dan project Google Cloud dengan penagihan yang diaktifkan. Anda juga harus memahami cara penagihan untuk penggunaan Maps Static API.

  1. Tinjau penagihan dan biaya penggunaan di Penggunaan dan Penagihan Maps Static API.

  2. Pastikan Anda memiliki Akun Google Cloud.

    Login ke Konsol Google Cloud

  3. Pastikan Anda memiliki project Google Cloud dengan penagihan yang diaktifkan.

    Buka halaman Penagihan
    1. Pilih project Anda untuk membuka halaman Billing.

    2. Di halaman Penagihan:

      • Jika penagihan telah diaktifkan untuk project yang dipilih, dan Anda hanya memiliki satu akun penagihan, halaman Billing akan terbuka.
      • Jika Anda memiliki beberapa akun penagihan, pilih Go to linked billing account untuk melihat detail tentang akun penagihan yang terkait dengan project.
      • Jika sudah memiliki akun penagihan, tetapi belum dikaitkan dengan project, Anda akan diminta untuk menautkan akun penagihan dengan project.
      • Jika belum memiliki akun penagihan, atau Anda ingin membuat akun penagihan baru, pilih Manage Billing Accounts untuk membuat akun penagihan baru. Untuk mengetahui informasi selengkapnya, lihat Membuat akun Penagihan Cloud layanan mandiri baru.

Mengaktifkan API

Sebelum dapat menggunakan Maps Static API, Anda harus menggunakan Konsol Google Cloud atau perintah gcloud untuk mengaktifkannya di project Google Cloud Anda.

Untuk mengaktifkan API:

Konsol

  1. Buka halaman produk di Konsol Google Cloud:

    Mengaktifkan Maps Static API

  2. Klik tombol Enable.

gcloud

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

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

Mendapatkan kunci API untuk digunakan dengan Maps Static API

Produk Google Maps Platform dilindungi dari penggunaan yang tidak sah dengan mewajibkan panggilan API menyertakan kunci API.

Kunci API adalah string alfanumerik unik yang mengaitkan akun Penagihan Cloud dan project Google Cloud Anda dengan permintaan yang dibuat aplikasi Anda ke API atau SDK Google Maps Platform. 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 Static 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 Static API.
      3. Klik Simpan.

    Memilih API di sini tidak akan mengaktifkannya. Pastikan Maps Static API diaktifkan di halaman Library API-nya.

  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.

gcloud

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=static-maps-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=static-maps-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 permintaan API

Buat permintaan Maps Static API di browser untuk menampilkan peta statis. Anda harus menyertakan string alfanumerik kunci API Anda dengan setiap permintaan dan menggunakan HTTPS untuk permintaan yang menyertakan kunci API.

  1. Klik API_KEY di URL di bawah untuk menyisipkan string alfanumerik kunci:

    https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY
  2. Klik ikon salin di contoh kode, Pilih ikon salin., untuk menyalin URL.
  3. Tempelkan URL ke jendela browser dan buka link.

Gambar akan muncul sebagai:

Peta pusat kota New York City.

Menerapkan pembatasan kunci API

Google sangat menyarankan agar Anda membatasi penggunaan kunci API hanya untuk API dan aplikasi yang memerlukannya. Membatasi kunci API akan meningkatkan keamanan aplikasi Anda dengan melindunginya dari permintaan yang tidak sah. Kunci API mendukung dua jenis pembatasan:

  • Pembatasan API menentukan SDK dan API mana yang dapat dipanggil menggunakan kunci API. Konsol dan gcloud CLI memerlukan setidaknya satu pembatasan API saat Anda membuat kunci.
  • Pembatasan aplikasi menentukan situs, alamat IP, atau aplikasi mana yang dapat menggunakan kunci API.

Untuk mengetahui informasi selengkapnya tentang cara menerapkan pembatasan, lihat Membatasi kunci API Anda.

Langkah berikutnya

Bergantung pada penggunaan Anda, tanda tangan digital - di samping kunci API - mungkin diperlukan untuk mengautentikasi permintaan. Untuk mengetahui informasi selengkapnya, lihat Menggunakan Tanda Tangan Digital.