代码示例概览

请选择平台： Android iOS JavaScript

Places SDK for iOS 随附的 SDK 演示应用演示了许多功能，包括地点自动补全和地点照片。此外，您还可以在本开发者指南的每个页面上找到代码段。

通过 CocoaPods 试用 SDK 演示应用

Places SDK for iOS 以 CocoaPods pod 的形式提供。CocoaPods 是一种用于 Swift 和 Objective-C Cocoa 项目的开源依赖项管理器。

Places SDK for iOS 提供了一组 SDK 演示应用，您可以使用 pod try 命令安装和运行这些应用：

请按照以下步骤安装 CocoaPods 并试用 Places SDK for iOS：

  1. 如果您尚未安装 CocoaPods 工具，请在 macOS 上从终端运行以下命令进行安装。如需了解详情，请参阅 CocoaPods 入门指南。 
    sudo gem install cocoapods
  2. 使用以下两种方法之一获取示例文件：

    使用 GitHub 中的文件

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

      Swift

      cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-master/GooglePlaces
    3. 运行以下命令：
      pod install
      
open GooglePlacesDemos.xcworkspace

    使用 CocoaPods v1.6.1

    1. 打开终端窗口并安装版本 1.6.1： 
      sudo gem install cocoapods -v1.6.1
    2. 使用 Cocoapods 获取 Google 地点文件： 
      pod try GooglePlaces

      CocoaPods 会更新您的规范代码库，然后在临时 Xcode 项目 GooglePlacesDemos.xcworkspace 中打开 SDK 演示版。

  3. 为您的 Google Cloud 控制台项目启用 Places SDK for iOS。
  4. 如果您还没有 API 密钥，请按照instructions在 Cloud 控制台上设置一个项目，并获取 API 密钥。在 Cloud 控制台中配置密钥时，您可以指定应用的软件包标识符，以确保只有您的应用可以使用该密钥。SDK 示例应用的默认软件包标识符为 com.example.GooglePlacesDemos。
  5. 修改 SDKDemoAPIKey 文件并将您的 API 密钥粘贴到相应的常量中。例如：

    Swift

    let placesAPIKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. 如果 Xcode 提示您解锁 SDKDemoAPIKey 文件以进行编辑，请选择 Unlock。
  7. 移除以下行（如果存在），因为它用于注册问题：

    Swift

    #error（注册 API 密钥并在此处插入。然后删除此行。”）

    Objective-C

    #error Register your API key and insert here, then delete this line.
  8. 再次编译并运行项目。
  9. 如果构建失败，或应用在您首次运行时因 API 密钥错误而崩溃，请确保您已在 SDKDemoAPIKey 文件中提供了所需的密钥。
  10. 如果您正在运行 GooglePlaces 演示，iOS 模拟器窗口将会显示一系列地点演示。
  11. 如果系统提示您允许 GooglePlacesDemos 获取您的位置信息，请选择允许。
  12. 现在可以运行您选择的示例了。

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

开发者指南中的每个页面都提供了说明 API 特定功能的代码段。例如，您可以参阅有关自动补全、获取当前地点、照片的指南，以及该指南中的其他页面。