Persiapan dan demo

Pilih platform: Android iOS

Halaman ini menjelaskan cara menyiapkan library utilitas untuk Maps SDK for iOS.

Untuk mencoba utilitas ini, Anda dapat:

Menambahkan Library Utilitas Maps SDK for iOS ke project Xcode

Ikuti langkah-langkah berikut untuk menambahkan library utilitas ke ruang kerja Xcode Anda:

Menggunakan Swift Package Manager

  1. Jika Anda belum memiliki project Xcode, buatlah sekarang dan simpan ke komputer lokal Anda. (Jika Anda baru dalam pengembangan iOS, buat project baru dan pilih iOS App template. Di Xcode 11.7 atau yang lebih lama, buat Single View Application.)
  2. Tambahkan Maps SDK for iOS sebagai dependensi. Lihat Menginstal SDK untuk mengetahui opsi.
  3. Di project Xcode Anda, buka File -> Swift Packages -> Add Package Dependency.
  4. Di jendela yang ditampilkan, masukkan URL repositori Library Utilitas Maps SDK for iOS https://github.com/googlemaps/google-maps-ios-utils dan pilih Next.
    • Pada tahap ini, Anda mungkin diminta untuk melakukan autentikasi dengan akun GitHub Anda. Ikuti petunjuk untuk membuat token akses pribadi GitHub guna melanjutkan proses.
  5. Di jendela berikutnya, pilih opsi radio Version, pilih Up to Next Major Version dari daftar drop-down, lalu masukkan versi terbaru Maps SDK for iOS Utility Library (misalnya, "6.0.0").
  6. Klik menu drop-down di samping Tambahkan ke Project, pilih project Anda, lalu pilih Tambahkan Paket.

Menambahkan kunci API ke aplikasi

Lihat Menyiapkan Project Xcode untuk mengetahui petunjuk cara membuat kunci API dan menambahkannya ke project Xcode Anda.

Membangun dan menjalankan project

Setelah menambahkan kunci API, bangun dan jalankan project.

Menggunakan utilitas di aplikasi Anda

Lihat dokumentasi setiap utilitas untuk mengetahui informasi selengkapnya tentang cara menggunakannya di aplikasi Anda:

Menginstal dan menjalankan aplikasi demo

Library utilitas mencakup aplikasi demo yang dapat Anda instal, lalu coba setiap utilitas.

Instal aplikasi demo:

Menggunakan file dari GitHub

  1. Download arsip contoh kode dari GitHub dan keluarkan arsip. Atau, buat clone repositori ke direktori lokal: 
    git clone https://github.com/googlemaps/google-maps-ios-utils.git
  2. Buka jendela terminal, buka direktori tempat Anda mengekstrak file contoh, dan lihat direktori contoh yang sesuai untuk bahasa yang ingin Anda gunakan:

    Swift

    cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeproj

    Objective-C

    cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj

Tambahkan kunci API ke aplikasi demo

Di Mendapatkan kunci API, Anda membuat kunci API untuk aplikasi Anda. Sekarang, tambahkan kunci tersebut ke project Xcode untuk aplikasi demo.

Swift

Tambahkan kunci API ke AppDelegate.swift sebagai berikut:

  1. Tambahkan pernyataan import berikut: 
    import GoogleMaps
  2. Edit baris berikut untuk menambahkan kunci API Anda di antara tanda petik ganda: 
    // Change this key to a valid key registered with the demo app bundle id.
let mapsAPIKey = ""

Objective-C

Tambahkan kunci API ke AppDelegate.m sebagai berikut:

  1. Tambahkan pernyataan import berikut: 
    @import GoogleMaps;
  2. Edit baris berikut untuk menambahkan kunci API Anda di antara tanda petik ganda: 
    // Change this key to a valid key registered with the demo app bundle id.
static NSString *const kMapsAPIKey = @"";

Mem-build dan menjalankan aplikasi demo

Setelah menambahkan kunci API, bangun dan jalankan project:

  • Jika menjalankan demo versi Swift, Anda dapat memilih utilitas yang akan dilihat di aplikasi.
  • Jika menjalankan demo versi Objective-C, Anda akan melihat demo utilitas pengelompokan penanda. Kemudian, Anda dapat mengedit versi demo Objective-C untuk mencoba setiap utilitas. Lihat bagian Menambahkan utilitas ke aplikasi Anda di bawah untuk mengetahui informasi selengkapnya.