设置和演示

请选择平台： Android iOS

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

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

• 安装并运行演示版应用。演示版应用是一个独立项目，包含试用实用程序所需的所有代码。
• 将实用程序库安装到现有的 Xcode 项目中。将这些实用程序添加到您自己的项目中。

（可选）安装 CocoaPods

实用程序库以名为 Google-Maps-iOS-Utils 的 CocoaPods pod 的形式提供。CocoaPods 是一种用于 Swift 和 Objective-C Cocoa 项目的开源依赖项管理器。

如果您尚未安装 CocoaPods 工具，请在 macOS 上从终端运行以下命令进行安装：

sudo gem install cocoapods

如需了解详情，请参阅 CocoaPods 入门指南。

安装并运行演示版应用

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

CocoaPods 1.8.1 及更高版本中的“pod try”存在一个已知问题。如果您想使用 Cocoapods 提取文件，我们建议您使用 CocoaPods 1.6.1 版。或者，您也可以从 GitHub 下载示例文件。

使用以下两种方法之一安装演示版应用：

使用 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 文件打开项目。

使用 CocoaPods v1.6.1

1. 打开终端窗口并安装 1.6.1 版：

   sudo gem install cocoapods -v1.6.1

2. 使用 Cocoapods 提取 Google 地图文件：

   pod try Google-Maps-iOS-Utils

   出现提示时，选择 Swift 或 Objective-C。CocoaPods 会更新您的规范代码库，然后在名为 SwiftDemoApp.xcodeproj 或 ObjCDemoApp.xcodeproj 的临时 Xcode 项目中打开演示版。

将 API 密钥添加到演示版应用

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

注意：如果您的 API 密钥设有应用限制，请务必将应用的软件包标识符添加到该密钥中。例如，如果您运行的是演示版应用，则软件包标识符为 com.google.gmsutils.DemoApp。如需详细了解如何限制密钥，请参阅获取 API 密钥。

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 版本的演示版来试用每个实用程序。如需了解详情，请参阅下面的向您的应用添加实用程序部分。

将实用程序库作为 Xcode 项目安装

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

使用 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, '13.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '7.4.0'
     pod 'Google-Maps-iOS-Utils', '4.2.2'
   end

4. 运行 pod install。
5. 关闭 Xcode，然后打开（双击）您项目的 .xcworkspace 文件以启动 Xcode。从此刻开始，您必须使用 .xcworkspace 文件打开项目。

注意：标记聚类实用程序依赖于四元树，但您也可以使用四叉树而不使用标记聚类。如果您只需要四叉树实用程序，可以在 Pod 文件中将 pod 'Google-Maps-iOS-Utils' 更改为 'Google-Maps-iOS-Utils/QuadTree'。

使用迦太基

1. 安装 Carthage。有几种方法，因此请参阅 Carthage README 文件，了解具体步骤。
2. 如果您尚未创建 Xcode 项目，请立即创建一个并将其保存到您的本地计算机上。（如果您刚开始接触 iOS 开发，请创建一个新项目，然后选择 iOS App template [iOS 应用模板]。在 Xcode 11.7 或早期版本中，创建一个 Single View Application [单视图应用]。）
3. 在您的项目目录中创建一个名为 Cartfile 的文件。此文件定义您项目的依赖项。
4. 修改 Cartfile 并添加 Maps SDK for iOS 实用程序库依赖项：
   

   github "googlemaps/google-maps-ios-utils"

5. 保存 Cartfile。
6. 在终端窗口中，转到包含 Cartfile 的目录：
   

   cd <path-to-project>

7. 运行更新命令：
   

   carthage update --platform iOS

   
   此命令将安装 Cartfile 中指定的 API 及其可能具有的任何依赖项。
8. 在 Finder 中，进入项目目录，找到 Carthage/Build/iOS 下已下载的框架文件。
9. 将以下软件包拖动到项目中，即可将 Maps SDK for iOS 框架添加到您的项目中。 （系统提示时，请选择 Copy items if needed, please use the same version as above（如果需要复制内容，请使用与上文相同的版本）。
   • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
10. 右键点击项目中的 GoogleMaps.framework，然后选择 Show In Finder（在查找器中显示）。
11. 将 Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle 从 Resources 文件夹拖动到您的项目中。系统显示提示时，确保没有选中“Copy items into destination group's folder”（将项目复制到目标组的文件夹）。
12. 从项目导航器中选择项目，然后选择应用的目标。
13. 打开应用目标对应的 Build Phases（构建阶段）标签页，并在 Link Binary with Libraries（将二进制文件与库相关联）中添加以下框架：
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

14. 选择项目而不是具体的目标，并打开“Build Settings”（构建设置）标签页。在“Other Linker Flags”（其他链接器标志）部分中，添加 -ObjC。如果看不到这些设置，请将“Build Settings”（构建设置）栏中的过滤条件从“Basic”（基本）更改为“All”（全部）。

使用 Swift Package Manager

1. 如果您还没有 Xcode 项目，请立即创建一个并将其保存到您的本地计算机上。 （如果您刚开始接触 iOS 开发，请创建一个新项目，然后选择 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，然后选择下一步。
• 此时，系统可能会提示您使用 GitHub 帐号进行身份验证。按照说明创建 GitHub 个人访问令牌，以继续此过程。
5. 在下一个窗口中，选择版本单选选项，从下拉列表中选择完全匹配，输入最新版本的 Maps SDK for iOS 实用程序库（例如“3.4.0”），然后选择下一步。

向您的应用添加 API 密钥

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

构建并运行项目

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

向应用中添加实用程序

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

• 标记聚类
• 四叉树
• KML 渲染
• GeoJSON 渲染
• 热图