MapsGL Apple SDK 是一款功能强大的地图库，专为 iOS 开发者设计。它支持将 MapsGL 丰富的地图功能集成到 iOS 应用程序中，提供无缝且互动性强的用户体验。
- 可视化实时天气和地理空间数据
- 使用 Metal 的高性能图层渲染
- 客户端可自定义的天气和地理空间信息呈现和样式
我们提供了深入的安装和设置指南，帮助您开始使用 MapsGL SDK for Apple 平台，可以使用 Swift Package Manager、Carthage 或直接将 MapsGL 的 xcframeworks 集成到 Xcode 中。
以下是运行包含的演示应用程序的基本说明，该应用程序为将 MapsGL 与您的应用程序集成提供了一个简单的模板。
MapsGL Apple SDK 包含一个演示应用程序，展示了 SDK 的功能。要运行演示应用程序，请按照以下步骤操作
- Xcode 15 或更高版本
- 一个 Apple Developer 开发者帐户
- iOS 16+ 设备（或 Xcode 的 iOS 模拟器）
- 一个 Xweather 帐户——我们提供一个免费开发者帐户，供您试用我们的天气 API。
- 一个 Mapbox 帐户
-
登录您的 Xweather 帐户，并从您帐户的应用页面中，为 MapsGL Demo 应用创建一个新的应用程序。记下应用程序的Xweather MapsGL ID 和密钥（Secret）；您将在步骤 5 中需要它们。
-
演示应用程序依赖于 Mapbox，因此您需要登录或创建一个 Mapbox 帐户，并按照Mapbox Maps SDK for iOS 安装说明的初始设置部分进行操作
- 按照“配置凭据”说明获取 Mapbox 公共访问令牌 和一个密钥访问令牌。
- 按照“配置您的密钥令牌”说明，使用您的 Mapbox 密钥访问令牌，以便能够下载 Mapbox SDK（通过演示应用程序中的 Swift Package Manager）。
- 记下您的 Mapbox 公共访问令牌；您将在步骤 5 中需要它。
-
将存储库克隆到您的本地计算机
git clone https://github.com/vaisala-xweather/mapsgl-apple-sdk.git -
在 Xcode 中打开
Demo.xcodeproj。 -
在运行演示之前，您需要配置 MapsGL 和 Mapbox 的访问密钥。
- 构建演示方案一次（产品菜单 ‣ 构建）以自动创建一个新的
AccessKeys.plist文件，然后单击左侧项目导航器中的AccessKeys.plist，并使用您上面记下的密钥填写MapboxAccessToken、XweatherClientID和XweatherClientSecret。
- 构建演示方案一次（产品菜单 ‣ 构建）以自动创建一个新的
-
在 Xcode 窗口顶部选择您的目标设备或模拟器，然后按“构建并运行”按钮 (▶)。
该演示应用程序演示了在 Mapbox 地图上渲染的各种栅格和编码的 MapsGL 图层。可以通过修改 WeatherLayersModel.swift 中的演示应用程序的 SwiftUI 视图模型进一步自定义图层，并且可以在 RepresentedMapboxMapView.swift 中自定义 Mapbox（这也是 MapsGL 通过 MapsGL 的 MapboxMapController 与 Mapbox 集成的地方）。进行实验、自定义，看看如何在您的应用程序中使用 MapsGL。
如果在运行演示应用程序时遇到任何问题，请确保
- 您的 Xcode 和 iOS 版本符合前提条件。
- 您已使用有效的 API 密钥正确配置了
AccessKeys.plist。 - 没有与缺少依赖项或配置相关的构建错误。