代码示例概览

选择平台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 Console 项目启用 Places SDK for iOS
  4. 如果您还没有 API 密钥,请按照说明在 Cloud Console 上设置项目并获取 API 密钥。在 Cloud Console 上配置密钥时,您可以指定应用的软件包标识符,以确保只有您的应用可以使用该密钥。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 特定功能的代码段。例如,请参阅有关自动补全获取当前地点照片和本指南中其他页面的指南。