适用于 Apple 平台的 MapsGL SDK

概述

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 开发者账号
• 一台 iOS 16+ 设备（或 Xcode 的 iOS 模拟器）
• 一个 Xweather 账号—我们为开发者提供 免费的开发者账号，以便您测试我们的天气 API。
• 一个 Mapbox 账号

运行步骤

1. 登录到您的 Xweather 账号，然后从 账号的应用页面 为 MapsGL 示例应用程序创建一个新应用。注意记录应用的 Xweather MapsGL ID 和 密钥；您在步骤 5 中需要它们。

2. 示例应用程序依赖 Mapbox，因此您需要登录或创建一个 Mapbox 账号，并按照 Mapbox Maps SDK for iOS 的安装说明 中的初始设置部分操作

   • 按照“配置凭据”说明获取一个 Mapbox 公共访问密钥 和一个 密钥密钥。
   • 使用您的 Mapbox 密钥密钥 根据“配置您的密钥密钥”说明操作，以便能够下载 Mapbox SDK（通过示例应用程序中的 Swift Package Manager）。
   • 注意您的 Mapbox 公共访问密钥；您在步骤 5 中需要它。

3. 将仓库复制到本地计算机

   git clone https://github.com/vaisala-xweather/mapsgl-apple-sdk.git

4. 在 Xcode 中打开 Demo.xcodeproj。

5. 在运行示例之前，您需要配置 MapsGL 和 Mapbox 的访问密钥。

   • 构建一次示例方案（产品菜单‣构建）以自动创建新的 AccessKeys.plist 文件，然后点击左边的项目导航器中的 AccessKeys.plist，用上面记录的密钥填写 MapboxAccessToken、XweatherClientID 和 XweatherClientSecret。

6. 在 Xcode 窗口顶部选择您的目标设备或模拟器，然后按构建和运行按钮（▶）。

探索示例

该演示应用展示了多种栅格和编码的MapsGL图层如何在Mapbox地图上渲染。可以通过修改WeatherLayersModel.swift中的演示应用SwiftUI视图模型来进一步自定义图层，并在RepresentedMapboxMapView.swift中定制Mapbox（这也是MapsGL通过MapsGL的MapboxMapController与Mapbox集成的地方）。实验、定制，看看如何在您的应用中使用MapsGL。

故障排除

在运行演示应用程序时，如果您遇到任何问题，请确保

• 您的Xcode和iOS版本满足最低要求。
• 您已正确配置AccessKeys.plist，其中包含有效的API密钥。
• 没有关于缺少依赖项或配置的错误。

如需进一步协助，请参阅文档或联系支持。