Maps SDK for iOS: Mendapatkan Kunci API

Catatan: Premium Plan Google Maps Platform tidak lagi tersedia untuk pendaftar atau pelanggan baru.

Untuk menggunakan Maps SDK for iOS, Anda harus memiliki kunci API. Kunci API adalah ID unik yang digunakan untuk mengautentikasi permintaan yang dikaitkan dengan project Anda untuk tujuan penggunaan dan penagihan.

Membuat kunci API

Anda harus memiliki setidaknya satu kunci API yang dikaitkan dengan project Anda.

Cara mendapatkan kunci API:

  1. Buka Google Cloud Platform Console.
  2. Klik drop-down project, lalu pilih project yang dibuat untuk Anda saat membeli Premium Plan. Nama project diawali dengan Google Maps API for Business atau Google Maps for Work atau Google Maps.
  3. Catatan: Untuk mendapatkan akses penuh ke fitur yang terdapat dalam paket, pelanggan Premium harus menggunakan project yang dikaitkan dengan akun Premium mereka. Saat membeli lisensi, Anda menerima nama aset Premium Anda dalam format berikut: gme-[company] & proj-[number] ([type]). Untuk memastikan Anda mengakses project yang benar, login ke konsol sebagai pemilik project mengggunakan console.cloud.google.com/project/number (ganti number dengan nomor project Anda ) Anda dapat menemukan pemilik project di email selamat datang.

  4. Klik tombol menu lalu pilih API & Layanan > Kredensial.
  5. Pada halaman Kredensial, klik Buat kredensial > Kunci API.
    Dialog kunci API dibuat menampilkan kunci API yang baru dibuat (string yang dienkripsi).
  6. Klik Tutup.
    Kunci API baru dicantumkan pada halaman Kredensial di bagian Kunci API.

Menambahkan kunci API ke aplikasi

Pada contoh berikut, ganti YOUR_API_KEY dengan kunci API Anda.

Swift

Tambahkan kunci API Anda ke AppDelegate.swift sebagai berikut:

  1. Tambahkan pernyataan impor berikut:
    import GoogleMaps
  2. Tambahkan hal berikut ke metode application(_:didFinishLaunchingWithOptions:), menggantikan YOUR_API_KEY dengan kunci API Anda:
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. Jika Anda juga menggunakan Places API, tambahkan kunci Anda lagi seperti yang ditunjukkan di sini:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Tambahkan kunci API Anda ke AppDelegate.m sebagai berikut:

  1. Tambahkan pernyataan impor berikut:
    @import GoogleMaps;
  2. Tambahkan hal berikut ke metode application:didFinishLaunchingWithOptions:, menggantikan YOUR_API_KEY dengan kunci API Anda:
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. Jika Anda juga menggunakan Places API, tambahkan kunci Anda lagi seperti yang ditunjukkan di sini:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Membatasi kunci API

Membatasi Kunci API akan meningkatkan keamanan aplikasi Anda dengan memastikan hanya permintaan yang sah yang dibuat dengan Kunci API Anda. Sebaiknya Anda mengikuti petunjuk untuk menetapkan pembatasan pada Kunci API Anda. Untuk informasi selengkapnya, lihat Praktik Terbaik Kunci API.

Cara membatasi kunci API:

  1. Di GCP Console, pada halaman pemilih project, pilih atau buat project Google Cloud yang ingin Anda tambahkan kunci API.

    Buka halaman pemilih project

  2. Buka halaman API & Layanan > Kredensial.

    Buka halaman Kredensial

  3. Pilih kunci API yang ingin Anda batasi. Halaman properti kunci API akan muncul.
  4. Di bagian Pembatasan kunci, tetapkan pembatasan berikut:
    • Pembatasan aplikasi:
      1. Pilih Aplikasi iOS.
      2. Untuk menerima permintaan dari aplikasi iOS dengan ID paket yang Anda berikan, pilih ID paket iOS yang sesuai dari daftar.
    • Pembatasan API:
      1. Klik Batasi kunci.
      2. Pilih Maps SDK for iOS dari drop-down Pilih API.
        (Jika Maps SDK for iOS tidak tercantum, Anda harus mengaktifkannya.)
  5. Untuk menyelesaikan perubahan, klik Simpan.