随 Maps SDK for iOS 提供的 SDK 演示应用包含 SDK 功能亮点的示例。检查演示应用中的代码,了解每个示例是如何实现的。
试用 SDK 演示版
Maps SDK for iOS SDK 演示版应用可从 GitHub 下载为下载归档文件,也可通过 CocoaPods pod 获取。CocoaPods 是一种用于 Swift 和 Objective-C Cocoa 项目的开源依赖项管理器。
请按照以下步骤安装并试用 Maps SDK for iOS SDK 演示应用。
- 使用以下两种方法之一获取示例文件:
直接通过 GitHub
- 从 GitHub 下载代码示例归档文件并解压缩。
- 打开一个终端窗口,导航到展开示例文件的目录,然后深入到 GoogleMaps 目录:
Swift
cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
Objective-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
- 运行以下命令:
Swift
pod install open GoogleMapsSwiftDemos.xcworkspace
Objective-C
pod install open GoogleMapsDemos.xcworkspace
使用 CocoaPods v1.6.1
- 如果您尚未安装 CocoaPods 工具,请在 macOS 上从终端运行以下命令来安装 1.6.1 版。如需了解详情,请参阅 CocoaPods 入门指南。
sudo gem install cocoapods -v1.6.1
- 使用 CocoaPods 提取 Google 地图文件:
pod try GoogleMaps
出现提示时,请选择 Swift 或 Objective-C。CocoaPods 会更新您的规范代码库,然后在名为
SwiftDemoApp.xcodeproj
或ObjCDemoApp.xcodeproj
的临时 Xcode 项目中打开演示版。
- 在 Xcode 中,按编译按钮进行构建,然后运行当前架构。构建系统会生成一个错误,提示您在
SDKConstants.swift
文件中针对 Swift 或SDKDemoAPIKey.h
文件(对于 Objective-C)输入 API 密钥。 - 如果您还没有 API 密钥,请按照说明在 Google Cloud Console 上设置项目并获取 API 密钥。在 Cloud Console 上配置密钥时,您可以指定应用的软件包标识符,以确保只有您的应用可以使用该密钥。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";
- 移除以下代码行,因为它用于注册用户定义的问题:
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 获取您的位置信息,请选择允许。
使用开发者指南中的代码段
开发者指南中的每个页面都提供了说明 API 特定功能的代码段。例如,您可以参阅有关地图对象、标记、形状的指南,以及该指南中的其他页面。