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:

• Instal library utilitas ke project Xcode yang ada. Tambahkan utilitas ini di project Anda sendiri.
• Instal dan jalankan aplikasi demo. Aplikasi demo adalah project mandiri yang berisi semua kode yang diperlukan untuk mencoba utilitas.

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, buatlah sekarang dan simpan ke komputer lokal Anda. (Jika Anda baru mengenal 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, 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 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 Version, pilih Up to Next Major Version dari daftar drop-down, dan masukkan versi terbaru Library Utilitas Maps SDK for iOS (misalnya, "6.0.0").
6. Klik menu drop-down di samping Tambahkan ke Project, pilih project Anda, lalu pilih Tambahkan Paket.

Menggunakan CocoaPods

1. Jika Anda belum memiliki project Xcode, buatlah sekarang dan simpan ke komputer 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 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, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '9.0.0'
     pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version
   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 ingin utilitas quadtree, Anda dapat mengubah pod 'Google-Maps-iOS-Utils' menjadi 'Google-Maps-iOS-Utils/QuadTree' dalam file pod.

Menambahkan kunci API ke aplikasi

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

Mem-build dan menjalankan project

Setelah menambahkan kunci API, build dan jalankan project.

Menggunakan utilitas di aplikasi Anda

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

• Pengelompokan penanda
• Quadtree
• Rendering KML
• Rendering GeoJSON
• Peta panas

Menginstal dan menjalankan aplikasi demo

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

Instal aplikasi demo:

Menggunakan file dari GitHub

1. Download arsip contoh kode dari GitHub dan ekstrak arsip.
2. Buka jendela terminal, buka direktori tempat Anda memperluas file contoh, lalu buka 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.

Menambahkan kunci API ke aplikasi demo

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

Catatan: Jika kunci API Anda menggunakan Pembatasan aplikasi, pastikan Anda menambahkan ID paket aplikasi ke kunci. Misalnya, jika Anda menjalankan aplikasi demo, ID paketnya adalah com.google.gmsutils.DemoApp. Lihat Mendapatkan kunci API untuk mengetahui informasi selengkapnya tentang pembatasan kunci.

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 menambahkan kunci API, build 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 Objective-C dari demo untuk mencoba setiap utilitas. Lihat bagian Menambahkan utilitas ke aplikasi di bawah untuk informasi selengkapnya.