GitHub GitHub 上提供的 Places SDK for iOS 演示版应用随 Places SDK for iOS 一起提供,演示了多项功能,包括地点自动补全和 Place Photos。此外,您亦可在本开发者指南的每个页面上找到代码段。 您可以导入并构建应用、添加 API 密钥、查看演示版功能,并以提供的示例代码为出发点开发您的应用。
当您运行示例应用时,它会显示一个包含可用示例的列表,您可以在自己的设备上运行这些示例。选择其中一个选项。
在本地运行完整示例应用
Places SDK for iOS 示例应用可从 GitHub 下载归档文件。请按照以下步骤安装并试用 Places SDK for iOS 示例应用。
- 从
GitHub
下载代码示例归档文件,然后解压缩该归档文件。或者,将代码库克隆到本地目录:
git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git
打开终端窗口,导航到解压缩示例文件的目录,然后深入到要使用的版本的目录:
SwiftUI
cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeprojSwift
cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeprojObjective-C
cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj- 在 Xcode 项目中,依次前往 File (文件)> Add Package Dependencies (添加软件包依赖项)。输入 https://github.com/googlemaps/ios-places-sdk 作为网址,按 Enter 键拉取软件包,然后点击 Add Package(添加软件包)。
- 为您的 Google Cloud 控制台项目启用 Places SDK for iOS 和 Maps SDK for iOS。
- 从启用了 Places API 和/或 Places API(新) 的项目中 获取 API 密钥。
- 按照下面的相应说明将 API 密钥添加到应用中。
SwiftUI
在与演示应用的
Info.plist文件 (GooglePlacesDemos/GooglePlacesDemos) 相同的目录中,为您的 API 密钥创建一个名为GooglePlacesDemos.xcconfig的本地配置文件。向配置文件添加两行代码,以定义您的 API 密钥:
PLACES_API_KEY = YOUR_PLACES_API_KEY和MAPS_API_KEY = YOUR_MAPS_API_KEY。将
YOUR_PLACES_API_KEY和YOUR_MAPS_API_KEY替换为上一步中的 API 密钥。如需有关创建本地配置文件的帮助,请参阅配置文件 (xcconfig) 格式。
Swift
修改
SDKDemoAPIKey文件,并将您的 API 密钥 粘贴到相应的常量中。例如:let placesAPIKey = "YOUR_API_KEY"
如果存在以下行,请将其移除:
#error (Register for API Key and insert here. Then delete this line.)
如果 Xcode 提示您解锁
SDKDemoAPIKey文件以进行 修改,请选择 Unlock。Objective-C
修改
SDKDemoAPIKey文件,并将您的 API 密钥 粘贴到相应的常量中。例如:static NSString *const kAPIKey = @"YOUR_API_KEY";
如果存在以下行,请将其移除
#error (Register for API Key and insert here. Then delete this line.)如果 Xcode 提示您解锁
SDKDemoAPIKey文件以进行 修改,请选择 Unlock。 - 构建应用。
- 如果构建失败,或者应用在首次运行时因 API 密钥 而崩溃并显示错误,请确保您已按照上述说明提供了所需的 密钥。
- 如果您运行示例应用,iOS 模拟器 窗口将显示地点演示列表。
- 如果系统提示您允许演示版应用访问您的位置信息,请选择 允许。
- 现在可以运行您选择的示例了。