代码示例概览

请选择平台： Android iOS JavaScript

Maps SDK for iOS 随附的 SDK 演示应用包含 SDK 功能亮点的示例。您可以检查演示版应用中的代码，了解每个示例的实现方式。

试用 SDK 演示版

Maps SDK for iOS SDK 演示版应用可通过 GitHub 下载归档和 CocoaPods Pod 获取。CocoaPods 是一种用于 Swift 和 Objective-C Cocoa 项目的开源依赖项管理器。

请按照以下步骤安装和试用 Maps SDK for iOS SDK 演示版应用。

  1. 使用以下两种方法之一获取示例文件：

    直接从 GitHub

    1. 从 GitHub 下载代码示例归档文件并解压缩归档文件。
    2. 打开终端窗口，转到您已展开示例文件的目录，然后深入到 GoogleMaps 目录：

      Swift

      cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-main/GoogleMaps
    3. 运行以下命令：

      Swift

      pod install
open GoogleMapsSwiftDemos.xcworkspace

      Objective-C

      pod install
open GoogleMapsDemos.xcworkspace

    使用 CocoaPods v1.6.1

    1. 如果您尚未安装 CocoaPods 工具，请在 macOS 上从终端运行以下命令来安装版本 1.6.1。如需了解详情，请参阅 CocoaPods 入门指南。 
      sudo gem install cocoapods -v1.6.1
    2. 使用 Cocoapods 提取 Google 地图文件： 
      pod try GoogleMaps

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

  2. 在 Xcode 中，按“compile”按钮进行构建，然后运行当前方案。构建生成错误，提示您在 SDKConstants.swift 文件中（对于 Swift）或 SDKDemoAPIKey.h 文件中（对于 Objective-C）输入 API 密钥。
  3. 如果您还没有 API 密钥，请按照instructions在 Google Cloud 控制台上设置一个项目，并获取 API 密钥。在 Cloud 控制台中配置密钥时，您可以指定应用的软件包标识符，以确保只有您的应用可以使用该密钥。SDK 示例应用的默认软件包标识符为 com.example.GoogleMapsDemos。
  4. 修改 SDKConstants.swift 文件（对于 Swift）或 SDKDemoAPIKey.h 文件（对于 Objective-C），然后将 API 密钥粘贴到 apiKey 或 kAPIKey 常量的定义中。例如：

    Swift

    static let apiKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  5. 移除以下行，因为它用于注册用户定义的问题：

    Swift

    #error (Register for API Key and insert here. Then delete this line.”)

    Objective-C

    #error Register for API Key and insert here.
  6. 构建并运行项目。此时将显示 iOS 模拟器窗口，其中显示了 Maps SDK 演示列表。
  7. 从显示的选项中选择一个，试用 Maps SDK for iOS 的功能。
  8. 如果系统提示您允许 GoogleMapsDemos 获取您的位置信息，请选择允许。

使用开发者指南中的代码段

开发者指南中的每个页面都提供了说明 API 特定功能的代码段。例如，您可以参阅有关地图对象、标记、形状的指南，以及该指南中的其他页面。