SuperAPI AI 工具集

weatherkit

通用与其它

查看项目

更新于 10-15 21:12

技能介绍

用途:在 Swift/iOS 应用中调用 WeatherService 获取天气数据。设置需在 Xcode 启用 WeatherKit 能力、在 Apple 开发者门户为 App ID 启用,使用设备定位时在 Info.plist 添加 NSLocationWhenInUseUsageDescription,且需有效 Apple 开发者计划会员。导入后可用 WeatherService.shared 或 WeatherService()。

主要能力:当前天气(温度、天气状况、湿度、风、UV 指数等);逐小时预报默认自当前小时起 25 小时;每日预报默认自当天起 10 天;分钟级降水预报(仅部分区域,可能为 nil);天气预警;选择性查询以减少配额与响应体积;.availability 报告预警与分钟预报可用性;iOS 18+ 支持 .changes 与 .historicalComparisons;历史摘要与统计通过 WeatherService 方法获取。

用法:使用 async/await 调用 weather(for:) 或带 including: 的查询;可传入 .current、.hourly、.daily、.minute、.alerts、.availability 等。日期范围查询 startDate 含、endDate 不含,可含 2021-08-01 起历史数据,未来至多 10 天,每次请求至多 10 个每日或约 240 个逐小时数据。温度用 Measurement.formatted() 按区域格式显示。

限制:必须展示 Apple Weather 归属(标记与 legalPageURL,无法显示时用 legalAttributionText),这是法律要求。未启用能力时调用会抛错。分钟预报在不受支持区域返回 nil,须处理可选值。应仅请求所需数据集,并依据 metadata.expirationDate 缓存。WeatherAvailability 仅涵盖预警与分钟可用性。更多 SwiftUI 面板、图表及历史统计模式见 references/weatherkit-patterns.md。