GitHub 上的 Maps SDK for iOS 代码库中包含一些示例,说明了如何在 iOS 应用中使用 Maps SDK for iOS。示例应用包含 SDK 的功能亮点代码,可用作应用的起点。
Maps SDK for iOS 示例列表
下面列出了该演示版应用中的关键示例活动,并在链接的页面进行了重现,以便于您快速参考。如需查看可用示例的完整列表,请参阅 GitHub 的示例文件夹。
在本地运行完整的示例应用
您可以从 GitHub 下载归档,获取 Maps SDK for iOS 示例应用。请按照以下步骤安装并试用 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-main/GoogleMaps-Swift
pod install
open GoogleMapsSwiftDemos.xcworkspace
Objective-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
pod install
open GoogleMapsDemos.xcworkspace
- 在 Xcode 中,按编译按钮以使用当前架构构建应用。构建引发错误,提示您在 Swift 的
SDKConstants.swift
文件或 Objective-C 的SDKDemoAPIKey.h
文件中输入 API 密钥。 - 如果您尚未获得 API 密钥,请按照说明在 Google Cloud 控制台中设置项目并获取 API 密钥。在 Cloud 控制台中配置密钥时,您可以将密钥限制为示例应用的软件包标识符,以确保只有您的应用可以使用该密钥。SDK 示例应用的默认软件包标识符为
com.example.GoogleMapsDemos
。 - 针对 Swift 编辑
SDKConstants.swift
文件,针对 Objective-C 编辑SDKDemoAPIKey.h
文件,然后将您的 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 获取您的位置信息,请选择允许。