Setelah mengaktifkan penagihan dan membuat kunci API, Anda siap menyiapkan project Xcode yang Anda gunakan untuk mengembangkan aplikasi Anda.
Catatan rilis tersedia untuk setiap rilis.
Langkah 1: Instal software yang diperlukan
Untuk membuat project menggunakan Places SDK for iOS, Anda memerlukan:
- Xcode versi 26.0 atau yang lebih baru
Langkah 2: Buat project Xcode dan instal Places SDK for iOS
Swift Package Manager
Places SDK for iOS dapat diinstal melalui Swift Package Manager. Untuk menambahkan SDK, pastikan Anda telah menghapus dependensi Places SDK for iOS yang ada.
Untuk menambahkan SDK ke project baru atau yang sudah ada, ikuti langkah-langkah berikut:
-
Buka
projectatauworkspaceXcode, lalu buka File > Add Package Dependencies. - Masukkan https://github.com/googlemaps/ios-places-sdk sebagai URL, tekan Enter untuk mengambil paket, lalu klik "Add Package".
-
Untuk menginstal
versiontertentu, tetapkan kolom Dependency Rule ke salah satu opsi berbasis versi. Untuk project baru, sebaiknya tentukan versi terbaru dan gunakan opsi "Exact Version". Setelah selesai, klik "Tambahkan Paket". - Dari jendela Choose Package Products, pastikan
GooglePlaces,GooglePlacesSwift, atau keduanya, akan ditambahkan ke target utama yang Anda tentukan. Setelah selesai, klik Tambahkan Paket.Jika Anda mengupdate Google Places Swift dari URL GitHub yang tidak digunakan lagi
Penting: URL GitHub untuk mengakses Google Places Swift telah berubah mulai versi 0.3.0. Jika Anda mengupdate versi GooglePlacesSwift yang diakses melalui URL lama,
https://github.com/googlemaps/ios-places-swift-sdk, hapus versi tersebut dari bagian dependensi paket Xcode Anda. - Untuk memverifikasi penginstalan, buka panel General target Anda. Di Frameworks, Libraries, and Embedded Content, Anda akan melihat paket yang diinstal. Anda juga dapat melihat bagian Package Dependencies di Project Navigator untuk memverifikasi paket dan versinya.
Untuk memperbarui package untuk project yang ada, ikuti langkah-langkah berikut:
-
Dari Xcode, buka File > Packages > Update To Latest Package Versions.
Jika Anda mengupdate Google Places Swift dari URL GitHub yang tidak digunakan lagi
Penting: URL GitHub untuk mengakses Google Places Swift telah berubah mulai versi 0.3.0. Jika Anda mengupdate versi GooglePlacesSwift yang diakses melalui URL lama,
https://github.com/googlemaps/ios-places-swift-sdk, hapus versi tersebut dari bagian dependensi paket Xcode Anda. - Untuk memverifikasi penginstalan, buka bagian Package Dependencies di Project Navigator untuk memverifikasi paket dan versinya.
Untuk menghapus Places SDK for iOS yang sudah ada dan diinstal secara manual, ikuti langkah-langkah berikut:
-
Dari setelan konfigurasi project Xcode, temukan Frameworks, Libraries,
and Embedded Content. Gunakan tanda minus (-) untuk menghapus framework berikut:
GooglePlaces.xcframeworkGooglePlacesSwift.xcframework
-
Dari direktori level teratas project Xcode Anda, hapus paket
GooglePlaces.
Penginstalan manual
Panduan ini menunjukkan cara menambahkan XCFrameworks yang berisi Places SDK for iOS dan Places Swift SDK for iOS secara manual ke project Anda dan mengonfigurasi setelan build di Xcode. XCFramework adalah paket biner yang dapat Anda gunakan di beberapa platform, termasuk mesin yang menggunakan Apple silicon. Anda dapat memilih untuk menambahkan Places SDK for iOS, Places Swift SDK for iOS, atau keduanya.
- Download file resource dan biner SDK berikut:
- Jika Anda menginstal Places Swift SDK for iOS, instal file berikut:
- Ekstrak file untuk mengakses XCFramework dan resource.
- Luncurkan Xcode dan buka project yang ada, atau buat project baru. Jika Anda baru mengenal pengembangan aplikasi iOS, buat project baru dan pilih template aplikasi iOS.
- Buang semua bundel Maps rilis sebelumnya dari proyek Anda.
-
Buka tab General. Tarik XCFramework berikut ke project Anda di bagian Frameworks, Libraries, and Embedded Content. Pastikan
untuk memilih Do Not Embed:
GooglePlaces.xcframework
GooglePlacesSwift.xcframework
-
Salin
GooglePlaces.bundledari GooglePlacesResources yang Anda download ke direktori level teratas project Xcode Anda. Pastikan untuk memilih Salin item ke folder grup tujuan saat diminta.
Jika Anda menginstal Places Swift SDK, salinGooglePlacesSwift.bundledari GooglePlacesSwiftResources yang Anda download ke direktori level teratas project Xcode Anda. Pastikan untuk memilih Salin item ke folder grup tujuan saat diminta. - Pilih project Anda dari Project Navigator, lalu pilih target aplikasi Anda.
-
Buka tab Build Phases. Dalam Link Binary with
Libraries, tambahkan framework dan library berikut:
CoreGraphics.frameworkCoreLocation.frameworklibc++.tbdlibz.tbdQuartzCore.frameworkUIKit.framework
-
Pilih project Anda, bukan target tertentu, lalu buka tab Build Settings. Di bagian Linking - General -> Other Linker Flags, tambahkan
-ObjCke "Debug" dan "Release". Jika setelan ini tidak terlihat, ubah filter di panel Build Settings dari Basic menjadi All.
Langkah 3: Tambahkan kunci API ke aplikasi Anda
Pada contoh berikut, ganti YOUR_API_KEY dengan kunci API Anda.
Tambahkan kunci API ke AppDelegate.swift sebagai berikut:
- Tambahkan pernyataan import berikut:
import GooglePlacesSwift
- Tambahkan kode berikut ke metode
application(_:didFinishLaunchingWithOptions:)Anda, dengan mengganti YOUR_API_KEY dengan kunci API Anda:PlacesClient.provideAPIKey("YOUR_API_KEY")
Swift
Tambahkan kunci API ke AppDelegate.swift sebagai berikut:
- Tambahkan pernyataan import berikut:
import GooglePlaces
- Tambahkan kode berikut ke metode
application(_:didFinishLaunchingWithOptions:)Anda, dengan mengganti YOUR_API_KEY dengan kunci API Anda:GMSPlacesClient.provideAPIKey("YOUR_API_KEY")
Objective-C
Tambahkan kunci API ke AppDelegate.m sebagai berikut:
- Tambahkan pernyataan import berikut:
@import GooglePlaces;
- Tambahkan kode berikut ke metode
application:didFinishLaunchingWithOptions:Anda, dengan mengganti YOUR_API_KEY dengan kunci API Anda:[GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];
Langkah 4 (opsional): Periksa file Manifes Privasi Apple
Apple mewajibkan detail privasi aplikasi untuk aplikasi di App Store. Buka halaman Detail Privasi Apple App Store untuk mengetahui info terbaru dan informasi selengkapnya.
File Manifes Privasi Apple disertakan dalam paket resource untuk SDK. Untuk memverifikasi bahwa File Manifes Privasi telah disertakan, dan untuk memeriksa kontennya, buat arsip aplikasi Anda dan buat laporan privasi dari arsip tersebut.
Langkah berikutnya
- Mulai menulis kode. Titik awal yang direkomendasikan adalah mengimplementasikan aplikasi awal yang mendapatkan tempat pengguna saat ini.
- Setelah project dikonfigurasi, Anda dapat mempelajari aplikasi contoh.
- Gunakan App Check untuk mengamankan kunci API Anda.