此页面由 Cloud Translation API 翻译。

设置 Xcode 项目

启用结算功能并创建 API 密钥后，您就可以设置用于开发应用的 Xcode 项目了。

每个版本都有相应的版本说明。

第 1 步：安装所需的软件

如需使用 Places SDK for iOS 构建项目，您需要：

Xcode 版本 15.0 或更高版本

第 2 步：创建 Xcode 项目并安装 Places SDK for iOS

Swift Package Manager

您可以通过 Swift Package Manager 安装 Places SDK for iOS。如需添加此 SDK，请确保您已移除所有现有的 Places SDK for iOS 依赖项。

如需将 SDK 添加到新项目或现有项目，请按以下步骤操作：

打开 Xcode project 或 workspace，然后依次点击 File > Add Package Dependencies。
输入 https://github.com/googlemaps/ios-places-sdk 作为网址，按 Enter 键提取软件包，然后点击“添加软件包”。
如需安装特定的 version，请将依赖项规则字段设置为某个基于版本的选项。对于新项目，我们建议指定最新版本并使用“确切版本”选项。完成后，点击“添加软件包”。
在 Choose Package Products 窗口中，验证 GooglePlaces 是否会添加到您指定的 main 目标。完成后，点击“添加软件包”。
如需验证您的安装，请前往目标的 General 窗格。在框架、库和嵌入式内容中，您应该会看到已安装的软件包。您还可以查看“Project Navigator”的“Package Dependencies”部分，验证软件包及其版本。

如需更新现有项目的 package，请按以下步骤操作：

如果您要从 9.0.0 之前的版本升级，则必须在升级后移除以下依赖项：GoogleMapsBase、GoogleMapsCore 和 GoogleMapsM4B。请勿移除 GoogleMaps 的依赖项。如需了解详情，请参阅版本 9.0.0 版本说明。

在您的 Xcode 项目配置设置中，找到框架、库和嵌入式内容。使用减号(-) 移除以下框架：
- GoogleMapsBase（仅适用于从 9.0.0 之前的版本进行的升级）
- GoogleMapsCore（仅适用于从 9.0.0 之前的版本进行的升级）
- GoogleMapsM4B（仅适用于从 9.0.0 之前的版本进行的升级）
在 Xcode 中，转到“File”（文件）>“Packages”（软件包）>“Update To Latest Package Versions”（更新到最新软件包版本）。
如需验证安装，请前往 Project Navigator 的 Package Dependencies 部分，验证软件包及其版本。

如需移除使用 CocoaPods 添加的现有 Places SDK for iOS 依赖项，请按以下步骤操作：

关闭 Xcode 工作区。打开终端并执行以下命令：

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

如果您不将 Podfile、Podfile.resolved 和 Xcode workspace 用于 CocoaPods 之外的任何其他项目，请移除它们。

如需移除手动安装的现有 Places SDK for iOS，请按以下步骤操作：

在您的 Xcode 项目配置设置中，找到框架、库和嵌入式内容。使用减号(-) 移除以下框架：
- GooglePlaces.xcframework
从 Xcode 项目的顶级目录中，移除 GooglePlaces 软件包。

Cocoapods

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 及其依赖项：

如果您尚未创建 Xcode 项目，请立即创建一个并将其保存到您的本地计算机上。如果您刚开始接触 iOS 开发，请创建一个新项目，然后选择 iOS 应用模板。
在您的项目目录中创建一个名为 Podfile 的文件。此文件可定义您项目的依赖项。
修改 Podfile 并添加您的依赖项及其versions。以下示例指定了您的应用目标名称和 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 以检测何时有更新版本，从而确保您始终处于最新版本。
保存 Podfile。
打开一个终端，然后转到包含 Podfile 的目录：
```
cd <path-to-project>
```
运行 pod install 命令。此操作会安装 Podfile 中指定的 API 及其可能具有的任何依赖项。
```
pod install
```
关闭 Xcode，然后打开（双击）您项目的 .xcworkspace 文件以启动 Xcode。从此刻开始，您必须使用 .xcworkspace 文件打开项目。

如需更新现有项目的 API，请按以下步骤操作：

打开终端，转到包含 Podfile 的项目目录。
运行 pod update 命令。这会将 Podfile 中指定的所有 API 更新到最新版本。

手动安装

本指南介绍了如何将包含 Places SDK for iOS 的 XCFramework 手动添加到您的项目，以及如何在 Xcode 中配置您的构建设置。XCFramework 是一个二进制软件包，可在多个平台（包括使用 Apple 芯片的计算机）上使用。

下载以下 SDK 二进制文件和资源文件：
- GooglePlaces
- GooglePlacesResources
解压缩文件以访问 XCFramework 和资源。
启动 Xcode，并打开现有的项目或创建新项目。如果您刚开始接触 iOS 开发，请创建一个新项目，然后选择 iOS 应用模板。
移除项目中之前版本的任何地图捆绑包。
打开常规标签页。将以下 XCFramework 拖动到项目中的 Frameworks, Libraries and Embedded Content 下。请务必选择 Do Not Embed：
- GooglePlaces.xcframework

GooglePlacesResources

GooglePlaces.bundle

将您下载的 GooglePlacesResources 中的 GooglePlaces.bundle 复制到您的 Xcode 项目的顶层目录中。出现提示时，请务必选择 Copy items into destination group's folder。
从项目导航器中选择您的项目，然后选择应用的目标。
打开 Build Phases 标签页。在将二进制文件与库关联中，添加以下框架和库：
- CoreGraphics.framework
- CoreLocation.framework
- libc++.tbd
- libz.tbd
- QuartzCore.framework
- UIKit.framework
选择您的项目（而不是具体的目标），并打开 Build Settings（构建设置）标签页。在 Linking - General -> Other Linker Flags 部分，将 -ObjC 添加到“Debug”和“Release”。如果看不到这些设置，请将“Build Settings”（构建设置）栏中的过滤条件从 Basic（基本）更改为 All（全部）。

GooglePlacesSwift

您可以使用 SPM、CocoaPods 和手动安装 GooglePlacesSwift（预览版）SDK。在所有进程中的安装步骤与 Places SDK for iOS 概述的步骤相同，区别如下：

需要 Xcode 15.3。
对于 SPM，还要将实例 GooglePlaces 替换为 GooglePlacesSwift。这包括 import 语句。
将版本号更新为 0.1.0。
将 https://github.com/googlemaps/ios-places-sdk 的实例替换为 https://github.com/googlemaps/ios-places-swift-sdk。
如果手动安装，除了 GooglePlaces XCFramework 和资源文件之外，您还需要添加 GooglePlacesSwift XCFramework 和资源文件。

第 3 步：检查 Apple 隐私清单文件

Apple 要求为 App Store 中的应用提供应用隐私权详细信息。如需了解最新动态和更多信息，请访问 Apple App Store 隐私权详情页面。

Apple 隐私清单文件包含在 SDK 的资源包中。如需验证隐私清单文件是否包含在内并检查其内容，请创建应用的归档，并从归档中生成隐私报告。

第 4 步：将 API 密钥添加到您的应用

在下例中，请将 YOUR_API_KEY 替换为您的 API 密钥。

Swift

按照以下方法向 AppDelegate.swift 添加 API 密钥：

添加以下 import 语句：
```
import GooglePlaces
```
将以下代码添加到您的 application(_:didFinishLaunchingWithOptions:) 方法中，并将 YOUR_API_KEY 替换为您的 API 密钥：
```
GMSPlacesClient.provideAPIKey("YOUR_API_KEY")
```

Objective-C

按照以下方法向 AppDelegate.m 添加 API 密钥：

添加以下 import 语句：
```
@import GooglePlaces;
```
将以下代码添加到您的 application:didFinishLaunchingWithOptions: 方法中，并将 YOUR_API_KEY 替换为您的 API 密钥：
```
[GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];
```

GooglePlacesSwift

按照以下方法向 AppDelegate.swift 添加 API 密钥：

添加以下 import 语句：
```
import GooglePlacesSwift
```
将以下代码添加到您的 application(_:didFinishLaunchingWithOptions:) 方法中，并将 YOUR_API_KEY 替换为您的 API 密钥：
```
PlacesClient.shared.provideAPIKey("YOUR_API_KEY")
```

第 5 步：开始编写代码

以下代码示例演示了如何获取当前地点。

请注意，由于此示例需要访问设备的位置信息才能获取当前位置，因此您需要在项目的 Info.plist 文件中使用适当的说明文本设置 NSLocationWhenInUseUsageDescription 键。如需了解详情，请参阅有关获取当前地点的指南。

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

后续步骤

配置项目后，您可以探索示例应用。您需要安装 Cocoapods v1.6.1。