設定 Xcode 專案

使用 Cocoapod

Places SDK for iOS 以 CocoaPod Pod 為例，GooglePlaces，其中包含所有地點功能。

CocoaPods 是適用於 Swift 和 Objective-C Cocoa 專案的開放原始碼依附元件管理工具。如果您尚未取得 CocoaPods 工具，請在終端機中執行下列指令，以便在 macOS 上安裝 。詳情請參閱 CocoaPods 入門指南。

sudo gem install cocoapods

為 Places SDK for iOS 建立 Podfile，並使用它安裝 SDK 及其依附元件：

1. 如果您還沒有 Xcode 專案，請立即建立一個並儲存至本機電腦 如果您是 iOS 開發新手，請建立新專案並選取「iOS App template」(iOS 應用程式範本)。
2. 在專案目錄中建立名為 Podfile 的檔案。這個檔案定義了專案的依附元件。
3. 編輯 Podfile 並新增依附元件及其版本。以下是指定應用程式目標名稱及 GooglePlaces pod 名稱的範例：

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '14.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GooglePlaces', '8.0.0'
   end
   

   請務必定期執行 pod outdated 以偵測是否有較新的版本，以確保您享有最新版本。
4. 儲存 Podfile。

5. 開啟終端機並前往包含 Podfile 的目錄：

   cd <path-to-project>

6. 執行 pod install 指令。此動作會安裝 Podfile 中指定的 API 及其所有依附元件。

   pod install

7. 關閉 Xcode，接著按兩下來開啟專案的 .xcworkspace 檔案來啟動 Xcode。從現在起，您必須使用 .xcworkspace 檔案來開啟專案。

如要更新現有專案的 API，請按照下列步驟操作：

1. 開啟終端機，前往含有 Podfile 的專案目錄。
2. 執行 pod update 指令。這會將 Podfile 中指定的所有 API 更新為最新版本。

使用購物車

Places SDK for iOS 適用於 Swift 和 Objective-C Cocoa 專案的簡易整合依附元件管理工具，適用 Carthage。

1. 安裝 Carthage。方法有很多，如需具體步驟，請查看「Carthage README」檔案。
2. 如果您還沒有 Xcode 專案，請立即建立一個並儲存至本機電腦 如果您是 iOS 開發新手，請建立新專案並選取「iOS App template」(iOS 應用程式範本)。
3. 在專案目錄中建立名為 Cartfile 的檔案。此檔案定義了專案的依附元件。
4. 編輯 Cartfile 並新增依附元件及其版本：
   

    binary "https://dl.google.com/geosdk/GooglePlaces.json" == 6.2.1

   請務必定期執行 carthage outdated，以偵測是否有較新的版本，確保您隨時都能使用最新版本。
5. 儲存 Cartfile。
6. 在終端機視窗中，前往包含 Cartfile 的目錄：
   

   cd <path-to-project>

7. 執行 carthage update 指令。此動作會安裝 Cartfile 中指定的 API 及其所有依附元件。
8. 在 Finder 中的專案目錄中，前往 Carthage/Build/iOS 底下的下載架構檔案。
9. 將下列軟體包拖曳至專案中 (系統顯示提示時，請選取「Copy items if needed」)：
   • GooglePlaces-x.x.x/Frameworks/GooglePlaces.xcframework
10. 以滑鼠右鍵按一下專案中的 GooglePlaces.xcframework，然後選取 [Show in Finder]。
11. 將 GooglePlaces.bundle 從 Resources 資料夾拖曳至您的專案。畫面顯示提示時，請確保您並未選取 [Copy items into destination group's folder]。
12. 從「Project Navigator」中選取您的專案，然後為您的應用程式選擇目標。
13. 開啟「Build Phases」分頁，然後在「Link Binary with Library」中新增下列架構和程式庫：
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework

14. 選擇專案，而非特定目標，然後開啟「Build Settings」分頁。

15. 在「Other Linker Flags」部分中，新增 -ObjC。如果這些設定沒有顯示，請將「Build Settings」列中的篩選器從「Basic」變更為「All」。

如要更新現有專案的 API，請按照下列步驟操作：

1. 開啟終端機，前往含有 Cartfile 的專案目錄。
2. 執行 carthage update 指令。這會將 Cartfile 中指定的所有 API 更新至最新版本。

手動安裝

本指南說明如何手動將 GooglePlaces 架構新增至專案，並在 Xcode 中進行建構設定。

1. 下載 SDK 來源檔案：GooglePlaces-8.0.0
2. 將來源檔案解除封裝。
3. 啟動 Xcode，接著開啟現有專案，或建立新專案。如果您是 iOS 開發新手，請建立新專案並選取「iOS App template」(iOS 應用程式範本)。
4. 從專案中移除先前版本中的所有地圖套件。
5. 將下列軟體包拖曳至專案中 (系統顯示提示時，請選取「Copy items if needed」)：
   • GooglePlaces-x.x.x/Frameworks/GooglePlaces.xcframework
6. 以滑鼠右鍵按一下專案中的 GooglePlaces.xcframework，然後選取 [Show in Finder]。
7. 將 GooglePlaces.bundle 從 Resources 資料夾拖曳至您的專案。畫面顯示提示時，請確保您並未選取 [Copy items into destination group's folder]。
8. 從「Project Navigator」中選取您的專案，然後為您的應用程式選擇目標。
9. 開啟「Build Phases」分頁，然後在「Link Binary with Library」中新增下列架構和程式庫：
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

10. 選擇專案，而非特定目標，然後開啟「Build Settings」分頁。

11. 在「Other Linker Flags」部分中，新增 -ObjC。如果這些設定沒有顯示，請將「Build Settings」列中的篩選器從「Basic」變更為「All」。

安裝 XCFramework

XCFramework 是一個二進位套件，可用於多個平台 (包括使用 M1 晶片組的機器)，用來安裝 Places SDK for iOS。本指南說明如何在專案中納入包含 Places SDK for iOS 的 XCFramework，以及如何在 Xcode 中調整建構設定。

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