Halaman ini diterjemahkan oleh Cloud Translation API.

Menyiapkan project Xcode

Setelah mengaktifkan penagihan dan membuat kunci API, Anda siap menyiapkan project Xcode yang digunakan 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 15.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 Xcode project atau workspace, lalu buka File > Add Package Dependencies.
Masukkan https://github.com/googlemaps/ios-places-sdk sebagai URL, tekan Enter untuk menarik paket, lalu klik "Tambahkan Paket".
Untuk menginstal version tertentu, tetapkan kolom Aturan Dependensi ke salah satu opsi berbasis versi. Untuk project baru, sebaiknya tentukan versi terbaru dan gunakan opsi "Versi Persis". Setelah selesai, klik "Add Package".
Dari jendela Choose Package Products, pastikan GooglePlaces akan ditambahkan ke target main yang ditetapkan. Setelah selesai, klik "Add Package".
Untuk memverifikasi penginstalan, buka panel General target Anda. Di bagian Framework, Library, dan Konten Tersemat, Anda akan melihat paket yang diinstal. Anda juga dapat melihat bagian "Dependensi Paket" pada "Project Navigator" untuk memverifikasi paket dan versinya.

Untuk mengupdate package bagi project yang sudah ada, ikuti langkah-langkah berikut:

Jika melakukan upgrade dari versi yang lebih lama dari 9.0.0, Anda harus menghapus dependensi berikut: GoogleMapsBase, GoogleMapsCore, dan GoogleMapsM4B setelah upgrade. Jangan hapus dependensi untuk GoogleMaps. Untuk informasi selengkapnya, lihat Catatan Rilis Versi 9.0.0.

Dari setelan konfigurasi project Xcode, temukan Frameworks, Library, dan Embedded Content. Gunakan tanda minus(-) untuk menghapus framework berikut:
- GoogleMapsBase (Hanya untuk upgrade dari versi yang lebih lama dari 9.0.0)
- GoogleMapsCore (Hanya untuk upgrade dari versi yang lebih lama dari 9.0.0)
- GoogleMapsM4B (Hanya untuk upgrade dari versi yang lebih lama dari 9.0.0)
Dari Xcode, buka "File > Packages > Update To Recent Package Versions".
Untuk memverifikasi penginstalan, buka bagian Package Dependencies pada Project Navigator untuk memverifikasi paket dan versinya.

Untuk menghapus dependensi Places SDK for iOS yang ada menggunakan CocoaPods, ikuti langkah-langkah berikut:

Tutup ruang kerja Xcode Anda. Buka terminal dan jalankan perintah berikut:

sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all

Hapus Podfile, Podfile.resolved, dan Xcode workspace jika Anda tidak menggunakannya untuk hal lain selain CocoaPods.

Untuk menghapus Places SDK for iOS yang diinstal secara manual, ikuti langkah-langkah berikut:

Dari setelan konfigurasi project Xcode, temukan Frameworks, Library, dan Embedded Content. Gunakan tanda minus(-) untuk menghapus framework berikut:
- GooglePlaces.xcframework
Dari direktori level teratas project Xcode Anda, hapus paket GooglePlaces.

CocoaPods

Places SDK for iOS tersedia sebagai pod CocoaPod, GooglePlaces, yang berisi semua kemampuan tempat.

CocoaPods merupakan pengelola dependensi open source untuk proyek Swift dan Objective-C Cocoa. 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

Buat Podfile untuk Places SDK for iOS dan gunakan untuk menginstal SDK serta dependensinya:

Jika Anda belum memiliki project Xcode, buatlah sekarang dan simpan ke komputer lokal Anda. Jika Anda masih awam dalam pengembangan iOS, buat project baru lalu pilih iOS App template.
Buat file bernama Podfile dalam direktori project Anda. File ini mendefinisikan dependensi project Anda.
Edit Podfile dan tambahkan dependensi Anda beserta versions. Berikut adalah contoh yang menentukan nama target aplikasi Anda dan nama pod GooglePlaces:
```
source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '8.3.0'
end
```
Pastikan untuk menjalankan pod outdated secara rutin guna mendeteksi saat ada versi yang lebih baru guna memastikan bahwa Anda selalu mendapatkan versi terbaru.
Simpan Podfile.
Buka terminal dan pilih direktori yang berisi Podfile:
```
cd <path-to-project>
```
Jalankan perintah pod install. Ini akan menginstal API yang ditentukan di Podfile, beserta dependensi yang mungkin dimiliki.
```
pod install
```
Tutup Xcode, lalu buka (klik dua kali) file .xcworkspace project Anda untuk meluncurkan Xcode. Mulai saat ini dan seterusnya, Anda harus menggunakan file .xcworkspace untuk membuka project.

Untuk mengupdate API untuk project yang sudah ada, ikuti langkah-langkah berikut:

Buka terminal dan buka direktori project yang berisi Podfile.
Jalankan perintah pod update. Tindakan ini akan mengupdate semua API yang ditentukan di Podfile ke versi terbaru.

Penginstalan manual

Panduan ini menunjukkan cara menambahkan XCFramework yang berisi Places 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.

Download file biner dan resource SDK berikut:
- GooglePlaces
- GooglePlacesResources
Ekstrak file untuk mengakses XCFramework dan resource.
Luncurkan Xcode dan buka project yang ada, atau buat project baru. Jika Anda masih awam dalam pengembangan iOS, buat project baru lalu pilih iOS App template.
Buang semua bundel Maps rilis sebelumnya dari proyek Anda.
Buka tab General. Tarik XCFramework berikut ke dalam project Anda di bagian Frameworks, Libraries, dan Embedded Content. Pastikan untuk memilih Do Not Embed:
- GooglePlaces.xcframework

GooglePlaces.bundle

GooglePlacesResources

Salin GooglePlaces.bundle dari GooglePlacesResources yang Anda download ke direktori level teratas project Xcode. Pastikan untuk memilih Copy items into destination group's folder saat diminta.
Pilih project Anda dari Project Navigator, dan pilih target aplikasi Anda.
Buka tab Build Phases. Dalam Link Binary with Libraries, tambahkan framework dan library berikut:
- CoreGraphics.framework
- CoreLocation.framework
- libc++.tbd
- libz.tbd
- QuartzCore.framework
- UIKit.framework
Pilih project Anda, bukan target tertentu, dan buka tab Build Settings. Di bagian Linking - General -> Other Linker Flags, tambahkan -ObjC ke "Debug" dan "Release". Jika setelan ini tidak terlihat, ubah filter di panel Build Settings dari Basic ke All.

GooglePlacesSwift

Anda dapat menginstal GooglePlacesSwift (Preview) SDK menggunakan Swift Package Manager, CocoaPods, dan secara manual. Langkah-langkah penginstalan di semua proses mencerminkan langkah-langkah yang diuraikan untuk Places SDK for iOS, dengan perbedaan berikut:

Xcode 15.3 wajib diisi.
Untuk Swift Package Manager, ganti juga instance GooglePlaces dengan GooglePlacesSwift. Ini termasuk pernyataan impor.
Perbarui nomor versi ke 0.1.0.
Ganti instance https://github.com/googlemaps/ios-places-sdk dengan https://github.com/googlemaps/ios-places-swift-sdk.
Jika menginstal secara manual, Anda perlu menambahkan file resource dan XCFramework GooglePlacesSwift, selain file resource dan XCFramework GooglePlaces.

Sebagai contoh, jika menggunakan CocoaPods, Podfile yang telah diedit adalah sebagai berikut:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '15.3'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlacesSwift', '0.1.0'
end

Langkah 3: Periksa file Apple Privacy Manifest

Apple memerlukan detail privasi aplikasi untuk aplikasi di App Store. Kunjungi halaman Detail Privasi Apple App Store untuk mendapatkan 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 4: Tambahkan kunci API ke aplikasi Anda

Pada contoh berikut, ganti YOUR_API_KEY dengan kunci API Anda.

Swift

Tambahkan kunci API ke AppDelegate.swift sebagai berikut:

Tambahkan pernyataan impor berikut:
```
import GooglePlaces
```
Tambahkan hal 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 impor berikut:
```
@import GooglePlaces;
```
Tambahkan hal berikut ke metode application:didFinishLaunchingWithOptions: Anda, dengan mengganti YOUR_API_KEY dengan kunci API Anda:
```
[GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];
```

GooglePlacesSwift

Tambahkan kunci API ke AppDelegate.swift sebagai berikut:

Tambahkan pernyataan impor berikut:
```
import GooglePlacesSwift
```
Tambahkan hal berikut ke metode application(_:didFinishLaunchingWithOptions:) Anda, dengan mengganti YOUR_API_KEY dengan kunci API Anda:
```
PlacesClient.shared.provideAPIKey("YOUR_API_KEY")
```

Langkah 5: Mulai menulis kode

Contoh kode berikut menunjukkan cara mendapatkan tempat saat ini.

Harap diperhatikan, karena contoh ini memerlukan akses ke lokasi perangkat untuk mendapatkan lokasi saat ini, Anda harus menyetel kunci NSLocationWhenInUseUsageDescription dengan teks penjelasan yang sesuai dalam file Info.plist project Anda. Untuk mengetahui detail selengkapnya, lihat panduan untuk mendapatkan tempat saat ini.

Swift

  import GooglePlaces
  import UIKit

  class GetStartedViewController : UIViewController {

    // Add a pair of UILabels in Interface Builder, and connect the outlets to these variables.
    @IBOutlet private var nameLabel: UILabel!
    @IBOutlet private var addressLabel: UILabel!

    private var placesClient: GMSPlacesClient!

    override func viewDidLoad() {
      super.viewDidLoad()
      placesClient = GMSPlacesClient.shared()
    }

    // Add a UIButton in Interface Builder, and connect the action to this function.
    @IBAction func getCurrentPlace(_ sender: UIButton) {
      let placeFields: GMSPlaceField = [.name, .formattedAddress]
      placesClient.findPlaceLikelihoodsFromCurrentLocation(withPlaceFields: placeFields) { [weak self] (placeLikelihoods, error) in
        guard let strongSelf = self else {
          return
        }

        guard error == nil else {
          print("Current place error: \(error?.localizedDescription ?? "")")
          return
        }

        guard let place = placeLikelihoods?.first?.place else {
          strongSelf.nameLabel.text = "No current place"
          strongSelf.addressLabel.text = ""
          return
        }

        strongSelf.nameLabel.text = place.name
        strongSelf.addressLabel.text = place.formattedAddress
      }
    }
  }

Objective-C

  #import "GetStartedViewController.h"
  @import GooglePlaces;

  @interface GetStartedViewController ()
  // Add a pair of UILabels in Interface Builder and connect the outlets to these variables
  @property (weak, nonatomic) IBOutlet UILabel *nameLabel;
  @property (weak, nonatomic) IBOutlet UILabel *addressLabel;
  @end

  @implementation GetStartedViewController {
    GMSPlacesClient *_placesClient;
  }

  - (void)viewDidLoad {
    [super viewDidLoad];
    _placesClient = [GMSPlacesClient sharedClient];
  }

  // Add a pair of UILabels in Interface Builder and connect the outlets to these variables.
  - (IBAction)getCurrentPlace:(UIButton *)sender {
    GMSPlaceField placeFields = (GMSPlaceFieldName | GMSPlaceFieldFormattedAddress);

    __weak typeof(self) weakSelf = self;
    [_placesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:placeFields callback:^(NSArray<GMSPlaceLikelihood *> * _Nullable likelihoods, NSError * _Nullable error) {
      __typeof__(self) strongSelf = weakSelf;
      if (strongSelf == nil) {
        return;
      }

      if (error != nil) {
        NSLog(@"An error occurred %@", [error localizedDescription]);
        return;
      }

      GMSPlace *place = likelihoods.firstObject.place;
      if (place == nil) {
        strongSelf.nameLabel.text = @"No current place";
        strongSelf.addressLabel.text = @"";
        return;
      }

      strongSelf.nameLabel.text = place.name;
      strongSelf.addressLabel.text = place.formattedAddress;
    }];
  }

  @end

GooglePlacesSwift

  struct ContentView: View {
    @State var place: Place?

    var body: some View {
      Button("Get Place") {
        // A hotel in Saigon with an attribution.
        let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"
        let fetchPlaceRequest = FetchPlaceRequest(
          placeID: placeID,
          placeProperties: [.displayName, .formattedAddress]
        )
        Task {
          switch await placesClient.fetchPlace(with: fetchPlaceRequest) {
          case .success(let place):
            self.place = place
          case .failure(let placesError):
            // Handle error
        }
      Text(swiftPlace?.displayName ?? "No place yet")
        .padding()
      Text(swiftPlace?.formattedAddress ?? "No place yet")
        .padding()
    }
  }

Langkah berikutnya

Setelah project dikonfigurasi, Anda dapat mempelajari aplikasi contoh.