Persiapan dan demo

Pilih platform: Android iOS

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

Untuk mencoba utilitas tersebut, Anda dapat:

Menginstal CocoaPods secara opsional

Library utilitas tersedia sebagai pod CocoaPods bernama Google-Maps-iOS-Utils. CocoaPods merupakan 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

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

Instal aplikasi demo dengan 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, pilih direktori tempat Anda memperluas file sampel, dan lihat perincian ke dalam direktori sampel 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, lalu membuka demo dalam project Xcode sementara 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 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 impor 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 menjalankan demo versi Objective-C, Anda akan melihat demo utilitas pengelompokan penanda. Anda kemudian dapat mengedit demo versi Objective-C untuk mencoba setiap utilitas. Lihat bagian Menambahkan aplikasi 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, buat project sekarang dan simpan ke mesin lokal Anda. (Jika Anda baru mengenal pengembangan iOS, buat Single View Application.)
  2. Jika Anda belum memiliki file pod untuk project, buat file bernama Podfile di direktori project Anda. File ini menentukan dependensi project Anda.
  3. Edit file pod project 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, '10.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  use_frameworks!
  pod 'GoogleMaps', '4.0.0'
  pod 'Google-Maps-iOS-Utils', '3.4.0'
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' di file pod.

Gunakan Carthage

  1. Instal Carthage. Ada beberapa metode, jadi lihat file README Carthage untuk mengetahui langkah-langkahnya.
  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 menentukan dependensi project 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 ada.
  8. Di Finder, dalam direktori project Anda, buka file framework yang didownload di bagian Carthage/Build/iOS.
  9. Tambahkan framework Maps SDK for iOS ke project Anda dengan menarik paket berikut ke dalam project Anda. (Saat diminta, pilih Salin item jika perlu, gunakan versi yang sama seperti di atas.)
    • 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
    Pelanggan Premium Plan juga harus menyertakan GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.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, buat project sekarang dan simpan ke komputer 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 opsi.
  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 dan pilih Next.
    • Pada tahap ini, Anda mungkin diminta untuk melakukan autentikasi dengan akun GitHub Anda. Ikuti petunjuk untuk membuat token akses pribadi GitHub untuk melanjutkan proses.
  5. Di jendela berikutnya, pilih opsi radio Versi, pilih Persis dari daftar drop-down, masukkan versi terbaru Library Utilitas Maps SDK for iOS (misalnya "3.4.0") dan pilih Berikutnya.

Menambahkan kunci API ke aplikasi

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

Mem-build dan menjalankan project

Setelah Anda menambahkan kunci API, build dan jalankan project.

Menambahkan aplikasi utilitas ke aplikasi Anda

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