代码示例概览

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。
选择平台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 特定功能的代码段。有关示例,请参阅本指南中的自动补全获取当前地点照片和其他页面指南。