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