随 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:
- 如果您尚未安装 CocoaPods 工具,请在 macOS 上从终端运行以下命令进行安装。如需了解详情,请参阅 CocoaPods 入门指南。
sudo gem install cocoapods
- 请使用以下两种方法之一获取示例文件:
使用 GitHub 中的文件
- 从 GitHub 下载代码示例归档文件并解压缩归档文件。
- 打开终端窗口,转到展开示例文件的目录,然后进入 GooglePlaces 目录展开细目:
Swift
cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift
Objective-C
cd maps-sdk-for-ios-samples-master/GooglePlaces
- 运行以下命令:
pod install
open GooglePlacesDemos.xcworkspace
使用 CocoaPods v1.6.1
- 打开一个终端窗口并安装 1.6.1 版:
sudo gem install cocoapods -v1.6.1
- 使用 CocoaPods 提取 Google 地点文件:
pod try GooglePlaces
CocoaPods 会更新您的规范代码库,然后在一个临时 Xcode 项目
GooglePlacesDemos.xcworkspace
中打开 SDK 演示版。
- 为您的 Google Cloud Console 项目启用 Places SDK for iOS。
- 如果您还没有 API 密钥,请按照说明在 Cloud Console 上设置项目并获取 API 密钥。在 Cloud Console 上配置密钥时,您可以指定应用的软件包标识符,以确保只有您的应用可以使用该密钥。SDK 示例应用的默认软件包标识符是
com.example.GooglePlacesDemos
。 - 修改
SDKDemoAPIKey
文件,并将您的 API 密钥粘贴到适当的常量中。例如:Swift
let placesAPIKey = "YOUR_API_KEY"
Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- 如果 Xcode 提示您解锁
SDKDemoAPIKey
文件进行修改,请选择 Unlock(解锁)。 - 如果存在以下行,请将其移除,因为它用于注册问题:
Swift
#error(注册 API 密钥并在此处插入。然后删除此行。”)
Objective-C
#error Register your API key and insert here, then delete this line.
- 再次编译并运行项目。
- 如果构建失败,或者应用在首次运行时因 API 密钥错误而崩溃,请确保您已在
SDKDemoAPIKey
文件中提供所需的密钥。 - 如果您运行 GooglePlaces 演示,iOS 模拟器窗口中会显示地点演示列表。
- 如果系统提示您允许 GooglePlacesDemos 获取您的位置信息,请选择允许。
- 现在可以运行您选择的示例了。
使用开发者指南中的代码段
开发者指南中的每个页面都提供了说明 API 特定功能的代码段。例如,请参阅有关自动补全、获取当前地点、照片和本指南中其他页面的指南。