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 pustaka utilitas ke workspace Xcode Anda:

Menggunakan Swift Package Manager

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

Menggunakan CocoaPods

  1. Jika Anda belum memiliki proyek Xcode, buat sekarang dan simpan ke komputer lokal Anda. (Jika Anda baru mengenal pengembangan iOS, buat Single Lihat Pendaftaran.)
  2. Jika Anda belum memiliki file pod untuk project, buatlah file bernama Podfile dalam direktori project Anda. File ini menentukan dependensi project-nya.
  3. Edit file pod project Anda dan tambahkan dependensi pada Google-Maps-iOS-Utils pod. Berikut adalah contoh yang mencakup dependensi yang Anda butuhkan untuk Maps SDK for iOS dan library utilitas: 
    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  use_frameworks!
  pod 'GoogleMaps', '9.0.0'
  pod 'Google-Maps-iOS-Utils', '6.0.0' # x-release-please-version
end
  4. Jalankan pod install.
  5. Tutup Xcode, lalu buka (klik dua kali) alamat .xcworkspace untuk meluncurkan Xcode. Mulai saat ini dan seterusnya, Anda harus menggunakan file .xcworkspace untuk membuka project.

Catatan: Utilitas pengelompokan penanda bergantung pada quadtree, tetapi Anda dapat menggunakan quadtree tanpa pengelompokan penanda. Jika Anda ingin hanya utilitas quadtree, Anda dapat mengubah pod 'Google-Maps-iOS-Utils' hingga 'Google-Maps-iOS-Utils/QuadTree' di file pod Anda.

Menambahkan kunci API ke aplikasi

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

Membangun dan menjalankan project

Setelah Anda menambahkan kunci API, build dan jalankan project.

Menggunakan utilitas di aplikasi Anda

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

Menginstal dan menjalankan aplikasi demo

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

Instal aplikasi demo dengan menggunakan salah satu dari dua metode berikut:

Menggunakan file dari GitHub

  1. Unduh arsip contoh kode dari GitHub dan membongkar arsip tersebut.
  2. Buka jendela terminal, navigasikan ke direktori tempat Anda memperluas {i>file<i} sampel, dan lihat direktori contoh yang sesuai untuk bahasa yang ingin Anda gunakan:
    • Untuk Swift, jalankan cd google-maps-ios-utils-master/samples/SwiftDemoApp
    • Untuk Objective-C, jalankan cd google-maps-ios-utils-master/samples/ObjCDemoApp
  3. Jalankan perintah berikut:
    pod install
  4. Tutup Xcode, lalu buka (klik dua kali) alamat .xcworkspace untuk meluncurkan Xcode. Mulai saat ini dan seterusnya, Anda harus menggunakan file .xcworkspace untuk membuka project.

Menggunakan CocoaPods v1.6.1

  1. Buka jendela terminal dan instal versi 1.6.1: 
    sudo gem install cocoapods -v1.6.1
  2. Ambil file Google Maps menggunakan Cocoapods: 
    pod try Google-Maps-iOS-Utils

    Pilih Swift atau Objective-C bila dikonfirmasi. CocoaPods memperbarui repositori spesifikasi Anda, lalu buka demo di project Xcode sementara bernama SwiftDemoApp.xcodeproj atau ObjCDemoApp.xcodeproj.

Menambahkan kunci API ke aplikasi demo

Di bagian 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 kutip 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 kutip 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 Anda menambahkan kunci API, build dan jalankan project:

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