Ringkasan Contoh Kode

Pilih platform: Android iOS JavaScript

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:

Ikuti langkah-langkah berikut untuk menginstal CocoaPods dan mencoba Places SDK for iOS:

  1. 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
  2. Dapatkan file contoh menggunakan salah satu dari dua metode berikut:

    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, 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
    3. Jalankan perintah berikut:
      pod install
      
open GooglePlacesDemos.xcworkspace

    Menggunakan CocoaPods v1.6.1

    1. Buka jendela terminal dan instal versi 1.6.1: 
      sudo gem install cocoapods -v1.6.1
    2. Ambil file Google Places menggunakan Cocoapods: 
      pod try GooglePlaces

      CocoaPods memperbarui repositori spesifikasi Anda, lalu membuka demo SDK dalam project Xcode sementara, GooglePlacesDemos.xcworkspace.

  3. Aktifkan Places SDK for iOS untuk project Google Cloud Console Anda.
  4. 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.
  5. 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";
  6. Jika Xcode meminta Anda membuka kunci file SDKDemoAPIKey untuk diedit, pilih Buka kunci.
  7. 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.
  8. Bangun dan jalankan lagi proyek tersebut.
  9. 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.
  10. Jika Anda menjalankan demo GooglePlaces, jendela simulator iOS akan menampilkan daftar Places Demos.
  11. Jika diminta untuk mengizinkan GooglePlacesDemos mengakses lokasi Anda, pilih Allow.
  12. 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.