一切就绪!

着手开发前,请先阅读我们的开发者文档

激活 Google Maps SDK for iOS

为帮助您起步,我们将引导您在 Google Developers Console 中先完成几项任务:

  1. 创建或选择项目
  2. 激活 Google Maps SDK for iOS
  3. 创建相应密钥
继续

设置和演示

此页面将介绍如何设置 Google Maps SDK for iOS 的实用程序库。如果您喜欢,您还可以将实用程序库的演示应用安装到临时 Xcode 项目中,并通过运行应用来了解内容库的功能。

获取 CocoaPods

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

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

sudo gem install cocoapods

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

(可选)安装并运行演示应用

实用程序库包括一个演示应用,您可以通过以下方式安装和运行此应用:

  1. 运行以下命令:
    pod try Google-Maps-iOS-Utils
  2. 出现提示时,选择 Swift 或 Objective-C。CocoaPods 会更新您的规范存储库,然后在一个名为 SwiftDemoApp.xcodeprojObjCDemoApp.xcodeproj 的临时 Xcode 项目中打开演示应用。

  3. 如果您没有 Google Maps API 密钥,请立即获取一个:
    1. 转至 Google API Console
    2. 创建或选择一个项目。
    3. 点击 Continue 以启用 Google Maps SDK for iOS。
    4. Credentials 页面上,获取 API 密钥
      注:如果您已有 iOS 特定的 API 密钥,可以使用该密钥。您可以在同一项目中的任何 iOS 应用上使用同一密钥。
    5. 从显示 API 密钥的对话框中,选择 Restrict key 以设置对该 API 密钥的 iOS 限制。
    6. Restrictions 部分,选择 iOS apps,然后输入应用的捆绑包标识符。例如:com.example.hellomap
    7. 点击 Save

      新的 iOS 特定 API 密钥会显示在项目的 API 密钥列表中。API 密钥是类似于如下的字符串:

      AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

    您也可以在 Google API Console 中查找现有密钥

  4. 编辑您的 Xcode 项目中的 AppDelegate.swiftAppDelegate.m 文件,然后将您的 API 密钥粘贴到 kMapsAPIKey 常量的定义中。
  5. 构建并运行项目。

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

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

  1. 如果您尚未创建 Xcode 项目,请立即创建一个并将其保存到您的本地计算机。(如果您刚开始接触 iOS 开发,请创建一个 Single View Application。)
  2. 如果您还没有为您的项目创建 pod 文件,请在您的项目目录中创建一个名为 Podfile 的文件。此文件定义您项目的依赖项。
  3. 编辑您项目的 pod 文件并在 Google-Maps-iOS-Utils pod 上添加依赖项。下面的示例包含 Google Maps SDK for iOS 和实用程序内容库需要的依赖项:
    source 'https://github.com/CocoaPods/Specs.git'
    
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleMaps'
      pod 'Google-Maps-iOS-Utils'
    end
  4. 运行 pod install
  5. 关闭 Xcode,然后打开(双击)您的项目的 .xcworkspace 文件以启动 Xcode。从此刻开始,您必须使用 .xcworkspace 文件打开项目。

:标记聚类实用程序依赖于四叉树,但是,您可以在没有标记聚类的情况下使用四叉树。如果只想使用四叉树实用程序,您可以在 pod 文件中将 pod 'Google-Maps-iOS-Utils' 更改为 'Google-Maps-iOS-Utils/QuadTree'

创建桥接标头(仅限 Swift)

如果您使用 Swift 创建项目,必须向您的项目中添加一个桥接标头,以便 Swift 可以使用实用程序库的 Objective-C 类。按照下面的步骤操作来添加桥接标头:

  1. 在您项目的根文件夹中添加一个新的标头文件。您可以随意为文件夹命名,扩展名为.h
  2. 将以下代码粘贴到文件中:
    #import <Google-Maps-iOS-Utils/GMUMarkerClustering.h>
    

    或者,如果您只想使用四叉树实用程序,请粘贴以下代码:

    #import <Google-Maps-iOS-Utils/GQTPointQuadTree.h>
    
  3. 保存文件。
  4. 在 Xcode 项目编辑器中,选择主项目。
  5. 转到 Xcode 构建编辑器中的 Build Settings
  6. 在构建设置中,查找 Swift Compiler - Code Generation
  7. Objective-C Bridging Header 部分,添加您所创建标头文件的路径。
  8. 构建项目。

如需了解更多详情,请参阅在同一项目中使用 Swift 和 Objective-C 的 Apple 指南。

获取 API 密钥

请点击下面的按钮,其指导您完成启用 Google Maps SDK for iOS 和获取 API 密钥的流程。如果您的项目已有 iOS 特定的 API 密钥,可以使用该密钥。

获取密钥

或者,请按照下列步骤获取 API 密钥:

  1. 转至 Google API Console
  2. 创建或选择一个项目。
  3. 点击 Continue 以启用 Google Maps SDK for iOS。
  4. Credentials 页面上,获取 API 密钥
    注:如果您已有 iOS 特定的 API 密钥,可以使用该密钥。您可以在同一项目中的任何 iOS 应用上使用同一密钥。
  5. 从显示 API 密钥的对话框中,选择 Restrict key 以设置对该 API 密钥的 iOS 限制。
  6. Restrictions 部分,选择 iOS apps,然后输入应用的捆绑包标识符。例如:com.example.hellomap
  7. 点击 Save

    新的 iOS 特定 API 密钥会显示在项目的 API 密钥列表中。API 密钥是类似于如下的字符串:

    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

您也可以在 Google API Console 中查找现有密钥

如需了解有关使用 Google API Console 的详细信息,请参阅 API Console 帮助

向您的应用添加 API 密钥

Swift

按以下步骤向 AppDelegate.swift 添加 API 密钥:

  1. 添加以下 import 语句:
    import GoogleMaps
  2. 向您的 application(_:didFinishLaunchingWithOptions:) 方法添加以下内容,使用您的 API 密钥替代 YOUR_API_KEY
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. 如果您也使用 Places API,请按下图所示再次添加密钥:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

按以下步骤向 AppDelegate.m 添加 API 密钥:

  1. 添加以下 import 语句:
    @import GoogleMaps;
  2. 向您的 application:didFinishLaunchingWithOptions: 方法添加以下内容,使用您的 API 密钥替代 YOUR_API_KEY
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. 如果您也使用 Places API,请按下图所示再次添加密钥:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

向您的应用添加标记聚类或四叉树

请参阅标记聚类四叉树指南。

发送以下问题的反馈:

此网页
Google Maps SDK for iOS
Google Maps SDK for iOS
需要帮助?请访问我们的支持页面