SuperAPI AI 工具集

weatherkit

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

WeatherKit 用于在 Apple 应用中获取天气数据。核心接口为 WeatherService.shared。使用前需在 Xcode 启用 WeatherKit 能力、在 Apple Developer 门户为 App ID 启用 WeatherKit;若通过 CoreLocation 请求坐标,需在 Info.plist 添加 NSLocationWhenInUseUsageDescription。

数据获取:调用 weather(for:) 可一次取回完整天气数据集,包括 currentWeather(当前天气)、hourlyForecast(逐小时预报)与 dailyForecast(逐日预报)等。为减少带宽与处理,可用 including: 参数只请求所需数据集,可选类型包括 .current、.hourly、.daily、.minute、.alerts。温度等 Measurement<UnitTemperature> 值应使用 .formatted() 输出,以遵循用户区域格式,避免手写华氏/摄氏转换。

iOS 18+ 扩展查询:可使用 .changes 获取天气变化(如相较昨日的温度变动),使用 .historicalComparisons 获取历史对比,并可获取摘要与统计信息。

署名要求:展示 WeatherKit 数据时必须显示 Apple Weather 署名,可通过 WeatherService.shared.attribution 获取,展示 attribution.combinedMark(浅色/深色 Apple Weather 标志),并提供指向 attribution.legalPageURL 的可点击链接;SwiftUI 中可用 Link 与官方标志资源呈现。缺少法律署名和标志会导致 App Store 审核被拒。

缓存与速率限制:应遵守预报随附的 metadata.expirationDate,避免重复获取未过期数据;按坐标批量请求并对位置更新做防抖,以符合 API 层级配额。

常见错误:省略强制署名、忽视预报过期时间而在每次视图出现时调用 weather(for:)、硬编码温度单位转换、在只需当前天气时请求全部数据集、未在开发者门户启用 WeatherKit 权限导致调用失败。

更多扩展模式(SwiftUI 仪表盘、图表集成、历史统计)见参考资料 references/weatherkit-patterns.md。部分细节如具体收费、价格与配额数值暂未提供。