Aplikasi demo SDK yang disediakan dengan Places SDK for iOS menunjukkan sejumlah fitur termasuk pelengkapan otomatis tempat dan foto tempat. Selain itu, Anda dapat menemukan cuplikan kode di setiap halaman dalam panduan developer ini.
Cobalah demo SDK menggunakan CocoaPods
Places SDK for iOS tersedia sebagai pod CocoaPods. CocoaPods merupakan pengelola dependensi open source untuk proyek Swift dan Objective-C Cocoa.
Places SDK for iOS menyediakan kumpulan aplikasi demo SDK yang dapat Anda instal dan jalankan menggunakan perintah pod try
:
- GooglePlaces menunjukkan pelengkapan otomatis tempat dan foto tempat.
Ikuti langkah-langkah berikut untuk menginstal CocoaPods dan mencoba Places SDK for iOS:
- Jika Anda belum memiliki alat CocoaPods, instal di macOS dengan menjalankan perintah berikut dari terminal. Untuk mengetahui detailnya, lihat Panduan Memulai CocoaPods.
sudo gem install cocoapods
- Dapatkan file contoh menggunakan salah satu dari dua metode berikut:
Menggunakan file dari GitHub
- Download arsip contoh kode dari GitHub dan ekstrak arsip.
- Buka jendela terminal, buka direktori tempat Anda memperluas file contoh, dan lihat perincian direktori GooglePlaces:
Swift
cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift
Objective-C
cd maps-sdk-for-ios-samples-master/GooglePlaces
- Jalankan perintah berikut:
pod install
open GooglePlacesDemos.xcworkspace
Menggunakan CocoaPods v1.6.1
- Buka jendela terminal dan instal versi 1.6.1:
sudo gem install cocoapods -v1.6.1
- Ambil file Google Places menggunakan Cocoapods:
pod try GooglePlaces
CocoaPods memperbarui repositori spesifikasi Anda, lalu membuka demo SDK dalam project Xcode sementara,
GooglePlacesDemos.xcworkspace
.
- Aktifkan Places SDK for iOS untuk project Google Cloud Console Anda.
- Jika Anda belum memiliki kunci API, ikuti petunjuk untuk menyiapkan project di Cloud Console dan dapatkan kunci API. Saat mengonfigurasi kunci di Cloud Console, Anda dapat menentukan ID paket aplikasi untuk memastikan bahwa hanya aplikasi Anda yang dapat menggunakan kunci tersebut. ID paket default
aplikasi contoh SDK adalah
com.example.GooglePlacesDemos
. - Edit file
SDKDemoAPIKey
dan tempel kunci API Anda ke dalam konstanta yang sesuai. Contoh:Swift
let placesAPIKey = "YOUR_API_KEY"
Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- Jika Xcode meminta Anda membuka kunci file
SDKDemoAPIKey
untuk diedit, pilih Buka kunci. - Jika ada, hapus baris berikut, karena digunakan untuk mendaftarkan masalah:
Swift
#error (Daftar untuk Kunci API dan masukkan di sini. Kemudian, hapus baris ini.”)
Objective-C
#error Register your API key and insert here, then delete this line.
- Bangun dan jalankan lagi proyek tersebut.
- Jika build gagal atau aplikasi mengalami error terkait kunci API
saat pertama kali Anda menjalankannya, pastikan Anda telah menyediakan
kunci yang diperlukan dalam file
SDKDemoAPIKey
. - Jika Anda menjalankan demo GooglePlaces, jendela simulator iOS akan menampilkan daftar Places Demos.
- Jika diminta untuk mengizinkan GooglePlacesDemos mengakses lokasi Anda, pilih Allow.
- Contoh yang Anda pilih kini siap dijalankan.
Menggunakan cuplikan kode dari panduan developer
Setiap halaman dalam panduan developer menyertakan cuplikan kode yang menggambarkan fitur tertentu dari API. Misalnya, lihat panduan untuk pelengkapan otomatis, mendapatkan tempat saat ini, foto, dan halaman lainnya dalam panduan ini.