Penyiapan

Halaman ini menjelaskan hal yang perlu Anda lakukan untuk menyiapkan dan mulai membangun dengan Maps 3D SDK for iOS. Proses penyiapan melibatkan konfigurasi project dan API Google Cloud untuk digunakan dengan SDK, lalu menyiapkan project Xcode. Selesaikan langkah-langkah ini sebelum menambahkan peta 3D pertama ke aplikasi Anda.

Prasyarat

Untuk menggunakan Maps 3D SDK for iOS, project dan perangkat target Anda harus memenuhi persyaratan berikut:

  • Minimum iOS version: Targetkan iOS 16.0 atau yang lebih baru.
  • Xcode: Xcode versi 16.0 atau yang lebih baru.

Menyiapkan project Google Cloud dan kunci API

Sebelum dapat mulai membangun dengan Maps 3D SDK for iOS, Anda harus menyiapkan project Google Cloud dan kunci API untuk digunakan dengan Maps 3D SDK for iOS dengan menyelesaikan langkah-langkah 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. Konfirmasi 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.

Perhatikan bahwa beberapa integrasi mengharuskan Anda untuk mengaktifkan beberapa API/SDK. Jika Anda tidak yakin API atau SDK mana yang harus diaktifkan, coba gunakan Capabilities Explorer, atau baca dokumentasi untuk API/SDK yang ingin Anda gunakan.

Untuk mengaktifkan satu atau beberapa API atau SDK:

Konsol

  1. Lihat API dan SDK Google Maps Platform yang dapat Anda aktifkan dengan membuka halaman Maps API Library di Konsol Cloud:

    Buka halaman Library Maps API

  2. Klik API atau SDK yang ingin Anda aktifkan.
    • Jika tombolnya bertuliskan ENABLE, klik tombol tersebut untuk mengaktifkan API atau SDK.
    • Jika tombolnya bertuliskan MANAGE, berarti API atau SDK sudah diaktifkan dan Anda tidak perlu melakukan tindakan apa pun.
    • Mengklik salah satu tombol akan menampilkan dasbor untuk API atau SDK. (Klik tombol DISABLE untuk menghapus API atau SDK dari project ini.)

Cloud SDK

Perintah berikut mengaktifkan semua Maps, Routes, dan Places API:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

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

Gunakan perintah ini untuk mengaktifkan Environment API:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

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 API yang akan Anda gunakan 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 API yang ingin Anda gunakan.
      3. Klik Simpan.

    Memilih API di sini tidak akan mengaktifkannya. Pastikan setiap API yang Anda pilih diaktifkan di 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. Ganti SERVICE_NAME dengan nama layanan API yang ingin Anda gunakan, seperti places.googleapis.com. Untuk mengizinkan lebih banyak API, ulangi flag --api-target.

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=SERVICE_NAME

    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. Ganti SERVICE_NAME dengan nama layanan API yang akan ditambahkan. 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=SERVICE_NAME

    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".

Untuk mengaktifkan SDK, lihat halaman Maps 3D SDK for iOS di Konsol Google Cloud. Untuk informasi selengkapnya tentang cara menyelesaikan langkah-langkah ini, lihat Memulai Google Maps Platform.

Menyiapkan project Xcode

Bagian ini menjelaskan cara membuat dan mengonfigurasi project Xcode untuk digunakan dengan Maps 3D SDK for iOS.

Setelah mengaktifkan penagihan dan membuat kunci API, Anda siap menyiapkan project Xcode yang Anda gunakan untuk mengembangkan aplikasi Anda.

Langkah 1: Instal software yang diperlukan

Untuk membuat project menggunakan Maps 3D SDK for iOS, Anda harus mendownload dan menginstal:

  • Xcode versi 16.0 atau yang lebih baru

Langkah 2: Buat project Xcode dan instal Maps 3D SDK for iOS

Swift Package Manager

Maps 3D SDK untuk iOS dapat diinstal menggunakan Swift Package Manager.

Untuk menambahkan SDK ke project baru atau yang sudah ada, ikuti langkah-langkah berikut:

  • Buka project atau workspace Xcode, lalu buka File > Add Package Dependencies.
  • Masukkan https://github.com/googlemaps/ios-maps-3d-sdk sebagai URL, tekan Enter untuk mengambil paket, lalu klik "Add Package".
  • Dari jendela Choose Package Products, pastikan GoogleMaps3D akan ditambahkan ke target utama yang Anda tentukan. Setelah selesai, klik Add Package.
  • Untuk memverifikasi penginstalan, buka panel General target Anda. Di Frameworks, Libraries, and Embedded Content, Anda akan melihat paket yang diinstal. Anda juga dapat melihat bagian Package Dependencies di Project Navigator untuk memverifikasi paket dan versinya.

Langkah 3: Tambahkan kunci API ke aplikasi Anda

Swift Package Manager

Tambahkan kunci API Anda ke titik entri utama untuk aplikasi Anda (atau kapan saja sebelum peta dimuat) seperti berikut.

  1. Tambahkan pernyataan impor berikut: 
    import GoogleMaps3D
  2. Tambahkan metode berikut. Ganti YOUR_API_KEY dengan kunci API Anda. 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

  var body: some View {
    Map(mode: .hybrid)
  }
}

Langkah 4 (opsional): Periksa file Manifes Privasi Apple

Apple mewajibkan detail privasi aplikasi untuk aplikasi di App Store.

File Manifes Privasi Apple disertakan dalam paket resource untuk SDK. Untuk memverifikasi bahwa File Manifes Privasi telah disertakan, dan untuk memeriksa isinya, buat arsip aplikasi Anda dan buat laporan privasi dari arsip tersebut.

Langkah berikutnya

Setelah menyiapkan project Google Cloud, kunci API, dan project Xcode untuk digunakan dengan Maps 3D SDK for iOS, Anda dapat Menambahkan peta 3D ke aplikasi.