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:

Menginstal CocoaPods secara opsional

Library utilitas tersedia sebagai pod CocoaPods yang bernama Google-Maps-iOS-Utils. CocoaPods adalah pengelola dependensi open source untuk project Swift dan Objective-C Cocoa.

Jika Anda belum memiliki alat CocoaPods, instal di macOS dengan menjalankan perintah berikut dari terminal:

sudo gem install cocoapods

Untuk mengetahui detailnya, lihat Panduan Memulai CocoaPods.

Menginstal dan menjalankan aplikasi demo

Pustaka utilitas menyertakan aplikasi demo yang bisa Anda instal lalu mencoba setiap utilitas.

Instal aplikasi demo menggunakan salah satu dari dua metode berikut:

Menggunakan file dari GitHub

  1. Download arsip contoh kode dari GitHub dan ekstrak arsip tersebut.
  2. Buka jendela terminal, buka direktori tempat Anda memperluas file contoh, dan lihat perincian 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) file .xcworkspace project Anda 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, kemudian membuka demo dalam project Xcode sementara yang bernama SwiftDemoApp.xcodeproj atau ObjCDemoApp.xcodeproj.

Menambahkan kunci API ke aplikasi demo

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

Swift

Tambahkan kunci API ke AppDelegate.swift sebagai berikut:

  1. Tambahkan pernyataan impor berikut: 
    import GoogleMaps
  2. Edit baris berikut untuk menambahkan kunci API 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 impor berikut: 
    @import GoogleMaps;
  2. Edit baris berikut untuk menambahkan kunci API 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, bangun dan jalankan project:

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

Pasang pustaka utilitas sebagai proyek Xcode

Ikuti langkah-langkah berikut untuk menambahkan pustaka utilitas ke workspace Xcode Anda:

Menggunakan CocoaPods

  1. Jika Anda belum memiliki project Xcode, buatlah sekarang dan simpan ke mesin lokal Anda. (Jika Anda baru mengenal pengembangan iOS, buat Single View Application.)
  2. Jika belum memiliki file pod untuk project Anda, buat file bernama Podfile di direktori project Anda. File ini menentukan dependensi project Anda.
  3. Edit file pod project Anda dan tambahkan dependensi pada pod Google-Maps-iOS-Utils. Berikut adalah contoh yang menyertakan dependensi yang Anda perlukan untuk Maps SDK for iOS dan library utilitas: 
    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '13.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  use_frameworks!
  pod 'GoogleMaps', '7.4.0'
  pod 'Google-Maps-iOS-Utils', '4.2.2'
end
  4. Jalankan pod install.
  5. Tutup Xcode, lalu buka (klik dua kali) file .xcworkspace project Anda 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 hanya menginginkan utilitas quadtree, Anda dapat mengubah pod 'Google-Maps-iOS-Utils' menjadi 'Google-Maps-iOS-Utils/QuadTree' dalam file pod Anda.

Menggunakan Carthage

  1. Instal Carthage. Ada beberapa metode, jadi lihat file README Carthage untuk langkah-langkah tepatnya.
  2. Jika Anda belum memiliki project Xcode, buatlah sekarang dan simpan ke komputer lokal Anda. (Jika Anda masih awam dengan pengembangan iOS, buat project baru lalu pilih iOS App template. Di Xcode 11.7 atau versi sebelumnya, buat Single View Application.)
  3. Buat file bernama Cartfile dalam direktori project Anda. File ini mendefinisikan dependensi proyek Anda.
  4. Edit Cartfile dan tambahkan dependensi Library Utilitas Maps SDK for iOS:
    github "googlemaps/google-maps-ios-utils"
  5. Simpan Cartfile.
  6. Di jendela terminal, buka direktori yang berisi Cartfile:
    cd <path-to-project>
  7. Jalankan perintah update:
    carthage update --platform iOS

    Tindakan ini akan menginstal API yang ditentukan dalam Cartfile, beserta dependensi yang mungkin dimiliki.
  8. Di Finder, di direktori project Anda, buka file framework yang didownload di bagian Carthage/Build/iOS.
  9. Tambahkan framework Maps SDK for iOS ke dalam project dengan menarik paket berikut ke project Anda. (Saat diminta, pilih Copy items if needed, please use the same version as above.)
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
  10. Klik kanan GoogleMaps.framework di project Anda, dan pilih Show in Finder.
  11. Tarik Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle dari folder Resources ke project Anda. Jika diminta, pastikan Copy items into destination group's folder tidak dipilih.
  12. Pilih project Anda dari Navigator Project, lalu pilih sasaran aplikasi Anda.
  13. Buka tab Build Phases untuk target aplikasi Anda, dan dalam Link Binary with Libraries, tambahkan framework berikut:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

  14. Pilih project Anda, bukan target tertentu, dan buka tab Build Settings. Di bagian Other Linker Flags, tambahkan -ObjC. Jika setelan ini tidak terlihat, ubah filter di bar Build Settings dari Basic ke All.

Menggunakan Swift Package Manager

  1. Jika Anda belum memiliki project Xcode, buatlah sekarang dan simpan ke mesin lokal Anda. (Jika Anda baru mengenal pengembangan iOS, buat project baru lalu 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 opsinya.
  3. Pada 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, lalu pilih Next.
    • Pada tahap ini, Anda mungkin akan diminta untuk melakukan autentikasi dengan akun GitHub Anda. Ikuti petunjuk untuk membuat token akses pribadi GitHub guna melanjutkan prosesnya.
  5. Di jendela berikutnya, pilih opsi pilihan pilihan Version, pilih Exact dari daftar dropdown, masukkan versi terbaru Library Utilitas Maps SDK for iOS (misalnya "3.4.0") dan pilih Next.

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 Anda menambahkan kunci API, build dan jalankan project.

Menambahkan utilitas ke aplikasi

Lihat dokumentasi tentang setiap utilitas untuk informasi selengkapnya tentang penggunaannya dalam aplikasi Anda: