GitHub 上的 Maps SDK for iOS 代码库中包含一些示例,说明了如何在 iOS 应用中使用 Maps SDK for iOS。示例应用包含 SDK 的功能亮点代码,可作为您应用的起点。
Maps SDK for iOS 示例列表
下面列出了演示版应用中的关键示例活动,并且在链接页中进行了介绍,以便于您快速查看。有关可用示例的完整列表,请查看 GitHub 示例文件夹。
在本地运行完整示例应用
Maps SDK for iOS 示例应用可从 GitHub 以下载归档的形式获取。请按照以下步骤安装并试用 Maps SDK for iOS 示例应用。
- 运行
git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git,将示例代码库克隆到本地目录。 打开一个终端窗口,前往您克隆示例文件的目录,然后深入到 GoogleMaps 目录:
Swift
cd maps-sdk-for-ios-samples/GoogleMaps-Swift
open GoogleMapsSwiftXCFrameworkDemos.xcodeprojObjective-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
open GoogleMapsDemos.xcodeproj- 在 Xcode 项目中,依次前往 File(文件)> Add Package Dependencies(添加软件包依赖项)。
输入
https://github.com/googlemaps/ios-maps-sdk作为网址,按 Enter 键拉取软件包,然后点击 Add Package。 - 在 Xcode 中,按下编译按钮,使用当前方案构建应用。构建会产生错误,提示您在
SDKConstants.swift文件(对于 Swift)或SDKDemoAPIKey.h文件(对于 Objective-C)中输入 API 密钥。 - 从已启用 Maps SDK for iOS 的项目中获取 API 密钥。
- 修改
SDKConstants.swift文件(对于 Swift)或SDKDemoAPIKey.h文件(对于 Objective-C),并将您的 API 密钥粘贴到apiKey或kAPIKey常量的定义中。例如:Swift
static let apiKey = "YOUR_API_KEY"
Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- 在
SDKConstants.swift文件 (Swift) 或SDKDemoAPIKey.h文件 (Objective-C) 中,移除以下行,因为该行用于注册用户定义的问题:Swift
#error (Register for API Key and insert here. Then delete this line.)
Objective-C
#error Register for API Key and insert here. - 构建并运行项目。系统会显示 iOS 模拟器窗口,其中列出了 Maps SDK 演示。
- 选择显示的选项之一,体验 Maps SDK for iOS 的功能。
- 如果系统提示您允许 GoogleMapsDemos 访问您的位置信息,请选择允许。