Penyiapan

Halaman ini menjelaskan hal-hal yang perlu Anda lakukan untuk menyiapkan diri agar dapat 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 berikut sebelum menambahkan peta 3D pertama ke aplikasi Anda.

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

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

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 Alat Pilih API, 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 Library Maps API 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

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 services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

Untuk mengaktifkan SDK, lihat halaman Maps 3D SDK for iOS di konsol Google Cloud. Untuk mengetahui informasi selengkapnya tentang cara menyelesaikan langkah-langkah ini, lihat artikel Mulai menggunakan 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 for iOS dapat diinstal menggunakan Swift Package Manager.

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

  • Buka Xcode project atau workspace, lalu buka File > Add Package Dependencies.
  • Masukkan https://github.com/googlemaps/ios-maps-3d-sdk sebagai URL, tekan Enter untuk menarik paket, lalu klik "Add Package".
  • Dari jendela Pilih Produk Paket, pastikan GoogleMaps3D akan ditambahkan ke target utama yang ditentukan. Setelah selesai, klik Tambahkan Paket.
  • Untuk memverifikasi penginstalan, buka panel Umum 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) sebagai 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 Anda.