Contoh kode Places SDK for iOS

Pilih platform: Android iOS JavaScript

Aplikasi demo Places SDK for iOS di GitHub yang disertakan dengan Places SDK for iOS menunjukkan sejumlah fitur, termasuk Place Autocomplete dan Place Photos. Selain itu, Anda dapat menemukan cuplikan kode di setiap halaman panduan developer ini. Impor dan buat aplikasi, tambahkan kunci API, lihat demo, dan gunakan kode contoh yang diberikan sebagai titik awal untuk aplikasi Anda.

Saat Anda jalankan, aplikasi contoh ini akan menampilkan daftar contoh yang tersedia dan dapat dijalankan di perangkat Anda sendiri. Pilih salah satu opsi.

Menjalankan aplikasi contoh lengkap secara lokal

Aplikasi contoh Places SDK for iOS tersedia sebagai arsip download dari GitHub Ikuti langkah-langkah berikut untuk menginstal dan mencoba aplikasi contoh Places SDK for iOS.

  1. Unduh arsip contoh kode dari GitHub dan ekstrak arsip. Atau, clone repositori ke direktori lokal: 
    git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git

  2. Buka jendela terminal, buka direktori tempat Anda mengekstrak file contoh, dan telusuri direktori untuk versi yang ingin Anda gunakan:

    SwiftUI

    cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeproj

    Swift

    cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeproj

    Objective-C

    cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj
  3. Di project Xcode, buka File > Add Package Dependencies. Masukkan https://github.com/googlemaps/ios-places-sdk sebagai URL, tekan Enter untuk menarik paket, lalu klik Add Package.
  4. Aktifkan Places SDK for iOS dan Maps SDK for iOS untuk project konsol Google Cloud Anda.
  5. Dapatkan kunci API dari project Anda dengan Places API dan/atau Places API (Baru) yang diaktifkan.
  6. Tambahkan kunci API ke aplikasi menggunakan petunjuk yang sesuai di bawah.

    SwiftUI

    Buat file konfigurasi lokal bernama GooglePlacesDemos.xcconfig untuk kunci API Anda, di direktori yang sama dengan file Info.plist aplikasi demo (GooglePlacesDemos/GooglePlacesDemos).

    Tambahkan dua baris ke file konfigurasi Anda untuk menentukan kunci API:

    PLACES_API_KEY = YOUR_PLACES_API_KEY dan MAPS_API_KEY = YOUR_MAPS_API_KEY.

    Ganti YOUR_PLACES_API_KEY dan YOUR_MAPS_API_KEY dengan kunci API dari langkah-langkah sebelumnya.

    Lihat Format File Setelan Konfigurasi (xcconfig) untuk mendapatkan bantuan terkait cara membuat file konfigurasi lokal.

    Swift

    Edit file SDKDemoAPIKey dan tempel kunci API Anda ke dalam konstanta yang sesuai. Contoh:

    let placesAPIKey = "YOUR_API_KEY"

    Jika ada, hapus baris berikut:

    #error (Register for API Key and insert here. Then delete this line.)

    Jika Xcode meminta Anda untuk membuka kunci file SDKDemoAPIKey untuk diedit, pilih Unlock.

    Objective-C

    Edit file SDKDemoAPIKey dan tempel kunci API Anda ke dalam konstanta yang sesuai. Contoh:

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    Jika ada, hapus baris berikut

    #error (Register for API Key and insert here. Then delete this line.)

    Jika Xcode meminta Anda untuk membuka kunci file SDKDemoAPIKey untuk diedit, pilih Unlock.

  7. Buat aplikasi.
  8. Jika build gagal atau aplikasi mengalami error terkait kunci API saat pertama kali Anda menjalankannya, pastikan Anda telah memberikan kunci yang diperlukan dalam petunjuk di atas.
  9. Jika Anda menjalankan aplikasi contoh, jendela simulator iOS akan menampilkan daftar Demo Places.
  10. Jika diminta untuk mengizinkan aplikasi demo mengakses lokasi Anda, pilih Allow.
  11. Contoh yang Anda pilih kini siap dijalankan.