Maps SDK for iOS 示例代码

请选择平台： Android iOS JavaScript

GitHub 上的 Maps SDK for iOS 代码库中包含一些示例，说明了如何在 iOS 应用中使用 Maps SDK for iOS。示例应用包含 SDK 的功能亮点代码，可用作应用的起点。

问题排查： 如果示例应用可成功运行，但您看不到地图，请确认您已按使用 API 密钥中所述向应用的清单文件中添加了 API 密钥。

Maps SDK for iOS 示例列表

下面列出了该演示版应用中的关键示例 activity，并且在链接页中进行了介绍，以便于您快速查看。如需查看可用示例的完整列表，请参阅 GitHub 的示例文件夹。

• 显示基本地图
• 显示标记的信息窗口
• 向地图添加标记
• 反向地理编码地点
• 启用和停用地图手势
• 处理标记事件
• 启用“我的位置”按钮
• 在地图上绘制多边形
• 在地图上绘制多段线

在本地运行完整示例应用

Maps SDK for iOS 示例应用以 GitHub 上的下载归档文件的形式提供。请按照以下步骤安装并试用 Maps SDK for iOS 示例应用。

1. 运行 git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git 以将示例代码库克隆到本地目录。

2. 打开一个终端窗口，然后导航到您克隆示例文件的目录，并展开 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

3. 在 Xcode 中，按 compile 按钮使用当前架构构建应用。构建引发错误，提示您在 Swift 的 SDKConstants.swift 文件或 Objective-C 的 SDKDemoAPIKey.h 文件中输入 API 密钥。
4. 如果您尚未获得 API 密钥，请按照说明在 Google Cloud 控制台中设置项目并获取 API 密钥。在 Cloud 控制台中配置密钥时，您可以将密钥限制为示例应用的软件包标识符，以确保只有您的应用可以使用该密钥。SDK 示例应用的默认 bundle 标识符为 com.example.GoogleMapsDemos。
5. 针对 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";

6. 在 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.

7. 构建并运行项目。出现 iOS 模拟器窗口，显示 Maps SDK 演示应用列表。
8. 从显示的选项中选择其一，对 Maps SDK for iOS 的其中一项功能进行试验。
9. 如果系统提示您允许 GoogleMapsDemos 访问您的位置信息，请选择允许。