设置和演示

请选择平台： Android iOS

本页介绍了如何设置 Maps SDK for iOS 的实用程序库。

如需试用这些实用程序，您可以执行以下任一操作：

将 Maps SDK for iOS 实用程序库添加到 Xcode 项目

按照下面的步骤操作，将实用程序库添加到您的 Xcode 工作区中：

使用 Swift Package Manager

  1. 如果您尚未创建 Xcode 项目，请立即创建一个并将其保存到您的本地计算机上。 （如果您刚开始接触 iOS 开发，请创建一个新项目，然后选择 iOS App template [iOS 应用模板]。在 Xcode 11.7 或更低版本中，创建一个 Single View Application [单视图应用]。）
  2. 将 Maps SDK for iOS 添加为依赖项。如需了解相关选项，请参阅安装 SDK。
  3. 在 Xcode 项目中，依次前往 File（文件）-> Swift Packages（Swift 软件包）-> Add Package Dependency（添加软件包依赖项）。
  4. 在随即显示的窗口中，输入 Maps SDK for iOS 实用程序库代码库网址 https://github.com/googlemaps/google-maps-ios-utils，然后选择 Next。
    • 此时，系统可能会提示您使用 GitHub 账号进行身份验证。按照说明创建 GitHub 个人访问令牌，以继续流程。
  5. 在下一个窗口中，选择 Version 单选按钮，从下拉列表中选择 Up to Next Major Version，然后输入 Maps SDK for iOS 实用程序库的最新版本（例如“6.0.0”）。
  6. 点击添加到项目旁边的下拉菜单，选择您的项目，然后选择添加软件包。

使用 CocoaPods

  1. 如果您尚未创建 Xcode 项目，请立即创建一个并将其保存到您的本地计算机上。（如果您刚开始接触 iOS 开发，请创建一个单视图应用。）
  2. 如果您的项目还没有 pod 文件，请在项目目录中创建一个名为 Podfile 的文件。此文件可定义您项目的依赖项。
  3. 修改项目的 pod 文件，并添加对 Google-Maps-iOS-Utils pod 的依赖项。下面的示例包含 Maps SDK for iOS 和实用程序库所需的依赖项： 
    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  use_frameworks!
  pod 'GoogleMaps', '9.0.0'
  pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version
end
  4. 运行 pod install。
  5. 关闭 Xcode，然后打开（双击）您项目的 .xcworkspace 文件以启动 Xcode。从此刻开始，您必须使用 .xcworkspace 文件打开项目。

注意：标记集群实用程序依赖于四分树，但您可以在不使用标记集群的情况下使用四分树。如果您只需要四叉树实用程序，可以在 pod 文件中将 pod 'Google-Maps-iOS-Utils' 更改为 'Google-Maps-iOS-Utils/QuadTree'。

向您的应用添加 API 密钥

如需了解如何生成 API 密钥并将其添加到 Xcode 项目，请参阅设置 Xcode 项目。

构建并运行项目

添加 API 密钥后，构建并运行项目。

在应用中使用实用程序

如需详细了解如何在应用中使用各个实用程序，请参阅相应实用程序的文档：

安装并运行演示版应用

实用程序库包含一个演示版应用，您可以安装该应用，然后试用每个实用程序。

安装演示版应用：

使用 GitHub 中的文件

  1. 从 GitHub 下载代码示例归档文件，然后解压缩该归档文件。
  2. 打开一个终端窗口，导航到您展开示例文件的目录，然后向下钻取到您要使用的语言的适当示例目录：
    • 对于 Swift，请运行 cd google-maps-ios-utils-master/samples/SwiftDemoApp
    • 对于 Objective-C，请运行 cd google-maps-ios-utils-master/samples/ObjCDemoApp
  3. 运行以下命令：
    pod install
  4. 关闭 Xcode，然后打开（双击）您项目的 .xcworkspace 文件以启动 Xcode。从此刻开始，您必须使用 .xcworkspace 文件打开项目。

向演示版应用添加 API 密钥

在获取 API 密钥中，您为应用生成了 API 密钥。现在，将该密钥添加到该演示版应用的 Xcode 项目中。

Swift

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

  1. 添加以下 import 语句： 
    import GoogleMaps
  2. 修改以下行，在双引号之间添加您的 API 密钥： 
    // Change this key to a valid key registered with the demo app bundle id.
let mapsAPIKey = ""

Objective-C

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

  1. 添加以下 import 语句： 
    @import GoogleMaps;
  2. 修改以下行，在双引号之间添加您的 API 密钥： 
    // Change this key to a valid key registered with the demo app bundle id.
static NSString *const kMapsAPIKey = @"";

构建并运行演示版应用

添加 API 密钥后，构建并运行项目：

  • 如果您运行的是 Swift 版本的演示版，则可以选择要在应用中查看哪些实用程序。
  • 如果您运行的是 Objective-C 版演示版，则会看到标记聚类实用程序的演示。然后，您可以修改该演示的 Objective-C 版本，以试用每个实用程序。 如需了解详情，请参阅下文的向应用添加实用程序部分。