設定 Xcode 專案

Swift 套件管理工具

您可以透過 Swift 套件管理工具安裝 Places SDK for iOS。如要新增 SDK，請確認您已移除所有現有的 Places SDK for iOS 依附元件。

如要將 SDK 加入新專案或現有專案，請按照下列步驟操作：

1. 開啟 Xcode project 或 workspace，然後依序前往「File」>「Add Package Dependencies」。
2. 輸入 https://github.com/googlemaps/ios-places-sdk 做為網址，然後按下 Enter 鍵提取套件，然後按一下「Add Package」。
3. 如要安裝特定的 version，請將「依附元件規則」欄位設為其中一個以版本為基礎的選項。如果是新專案，建議您指定最新版本並使用「精確版本」選項。完成後，按一下「新增套件」。
4. 在「選擇套件產品」視窗中，確認 GooglePlaces 會新增至指定的 main 目標。完成後，按一下「新增套件」。
5. 如要驗證安裝狀態，請前往目標的 General 窗格。在「Frameworks、Library and Embedded Content」中應會顯示已安裝的套件。您也可以查看「Project Navigator」的「Package Dependencies」部分，確認套件及其版本。

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

1. 如果您要從 9.0.0 以下版本升級，必須在升級後移除下列依附元件：GoogleMapsBase、GoogleMapsCore 和 GoogleMapsM4B。請勿移除 GoogleMaps 的依附元件。詳情請參閱 9.0.0 版本資訊。

   在 Xcode 專案設定設定中，找到「Frameworks、Library 和 Embedded Content」。請使用減號(-) 移除下列架構：

   • GoogleMapsBase (僅適用於 9.0.0 以下版本的升級作業)
   • GoogleMapsCore (僅適用於 9.0.0 以下版本的升級作業)
   • GoogleMapsM4B (僅適用於 9.0.0 以下版本的升級作業)
2. 在 Xcode 中，前往 [檔案] > [套件] > [更新至最新套件版本]。
3. 如要驗證安裝狀態，請前往「Project Navigator」的「Package Dependencies」部分，檢查套件及其版本。

如要移除使用 CocoaPods 新增的現有 Places SDK for iOS 依附元件，請按照下列步驟操作：

1. 關閉 Xcode 工作區。開啟終端機並執行下列指令：

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

2. 如果您未在 CocoaPods 以外的地方使用 Podfile、Podfile.resolved 和 Xcode workspace，請移除這些項目。

1. 在 Xcode 專案設定設定中，找到「Frameworks、Library 和 Embedded Content」。請使用減號(-) 移除下列架構：
   • GooglePlaces.xcframework
2. 在 Xcode 專案的頂層目錄中，移除 GooglePlaces 軟體包。

CocoaPods

Places SDK for iOS 以 CocoaPod Pod 的形式提供，該 Pod GooglePlaces 會包含所有地點功能。

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

sudo gem install cocoapods

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

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

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GooglePlaces', '8.3.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 的 XCFramework 新增至專案，並在 Xcode 中完成建構設定。XCFramework 是可以在多種平台上使用的二進位套件，包括使用 Apple 晶片的機器。

1. 下載下列 SDK 二進位檔和資源檔案：
   • GooglePlaces
   • GooglePlacesResources
2. 解壓縮檔案以存取 XCFramework 和資源。
3. 啟動 Xcode，接著開啟現有專案，或建立新專案。如果您是 iOS 開發新手，請建立新專案並選取「iOS App Template」。
4. 從專案中移除先前版本中的所有地圖套件。
5. 開啟「一般」分頁。將下列 XCFramework 拖曳至專案「Frameworks、Library and Embedded Content」。並務必選取「不要嵌入」：
   • GooglePlaces.xcframework
從已下載的 GooglePlacesResources 拖曳 GooglePlaces.bundle
6. 將您下載的 GooglePlacesResources 中的 GooglePlaces.bundle 複製到 Xcode 專案的頂層目錄。系統提示時，請務必選取「Copy items to destination group's folder」。
7. 從專案導覽器中選取專案，然後選擇應用程式目標。
8. 開啟「Build Phases」分頁。在「連結二進位檔與程式庫」中，新增下列架構和程式庫：
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

9. 選擇您的專案 (而非特定目標)，然後開啟「Build Settings」分頁。在「Linking - General」->「Other Linker Flags」部分中，將 -ObjC 新增至「Debug」和「Release」。如未顯示這些設定，請將「Build Settings」列中的篩選器從「Basic」變更為「All」。

GooglePlacesSwift

您可以使用 Swift Package Manager、CocoaPods 和手動安裝 GooglePlacesSwift (預先發布版) SDK。所有程序的安裝步驟皆與 Places SDK for iOS 所述的步驟相同，但有下列差異：

• Xcode 15.3 為必要項目。
• 如果您使用的是 Swift 套件管理工具，則必須將 GooglePlaces 的執行個體替換為 GooglePlacesSwift。其中包括匯入陳述式。
  • 將 https://github.com/googlemaps/ios-places-sdk 執行個體替換為 https://github.com/googlemaps/ios-places-swift-sdk。
• 將版本號碼更新為 0.1.0。
• 如要手動安裝，請下載下列 SDK 二進位檔和資源檔案：
  • GooglePlacesSwift
  • GooglePlacesSwiftResources
  • GooglePlaces
  • GooglePlacesResources

舉例來說，如果使用 CocoaPods，編輯的 Podfile 看起來會像這樣：

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

platform :ios, '15.3'

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

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()
    }
  }