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 dalam 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, contoh aplikasi 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. Download arsip contoh kode dari GitHub dan keluarkan 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, lalu buka 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 untuk project Google Cloud Console Anda.
  5. Dapatkan kunci API dari project Anda dengan Places API dan/atau Places API (Baru) 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 baris ke file konfigurasi Anda untuk menentukan kunci API Anda:

    PLACES_API_KEY = YOUR_PLACES_API_KEY

    Ganti YOUR_PLACES_API_KEY dengan kunci API dari langkah sebelumnya.

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

    Swift

    Edit file SDKDemoAPIKey dan tempelkan 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 pengeditan, pilih Unlock.

    Objective-C

    Edit file SDKDemoAPIKey dan tempelkan 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 pengeditan, pilih Unlock.

  7. Bangun aplikasi.
  8. Jika build gagal atau aplikasi error dengan pesan tentang kunci API Anda saat Anda menjalankannya pertama kali, 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 Izinkan.
  11. Contoh yang Anda pilih kini siap dijalankan.