此 SDK 帮助您使用 Swift 访问 Stadia Maps 的全套地理空间 API。使用 Xcode,您将在键入时获得所有好东西,例如自动完成、类型定义和文档。所有 API 方法都利用了 Swift 5.5 中引入的异步功能,这使得编写正确的异步代码比以往任何时候都更容易。
Xcode UI 经常更改,但您通常可以使用“文件”菜单中的选项将软件包添加到您的项目中。然后,您需要粘贴存储库 URL 以进行搜索:https://github.com/stadiamaps/stadiamaps-api-swift。有关 Apple 提供的最新详细说明,请参阅 https://developer.apple.com/documentation/xcode/adding-package-dependencies-to-your-app。
您需要一个 API 密钥才能使用 Swift SDK。
您可以在此处免费创建 API 密钥(无需信用卡)。
您可以像这样配置您的 API 密钥
StadiaMapsAPI.customHeaders = ["Authorization": "Stadia-Auth YOUR-API-KEY"]
如果您想使用我们的欧盟端点以将流量保持在欧盟境内,您可以设置 basePath
属性。
StadiaMapsAPI.basePath = "https://api-eu.stadiamaps.com"
您可以在集成测试中找到有关如何调用我们所有 API 方法的示例。
官方文档位于 docs.stadiamaps.com,我们在那里提供了每个端点的长篇散文式解释和一个交互式 API 参考。