开始使用 WeatherKit
WeatherKit,搭配全新的 Apple 天气服务,为 App 和服务提供丰富且有价值的天气数据,帮助人们获取最新预报,未雨绸缪地做好安全措施。了解在开始使用前所需满足的要求和用到的工具,以及如何从 Dark Sky 天气服务过渡到 WeatherKit。
WeatherKit,搭配全新的 Apple 天气服务,为 App 和服务提供丰富且有价值的天气数据,帮助人们获取最新预报,未雨绸缪地做好安全措施。了解在开始使用前所需满足的要求和用到的工具,以及如何从 Dark Sky 天气服务过渡到 WeatherKit。
Apple Developer Program 包含 WeatherKit,还提供开发和分发 App 所需的一切工具、资源和支持 — 包括获取 Beta 版软件、App 服务、测试工具以及 App 分析等。
WeatherKit 要求使用 iOS 16、iPadOS 16、macOS 13、Apple tvOS 16 或 watchOS 9。REST API 可用于网站和其他平台。
每个 Apple Developer Program 会员资格每月将包含 WeatherKit 的 50 万次 API 调用。如果你需要额外的 API 调用次数,你的 Apple Developer Program 会员资格的账户持有人可以在 Apple Developer App 的“账户”标签页中订阅。订阅方案以美元或可用的当地货币定价。
账户持有人可以随时对订阅进行升级或降级。对于账户持有人:
请注意,未使用的 API 调用数不会结转到次月。
当你在自己的 App、网页版 App 或网站中使用 WeatherKit 时,需要遵循关于归因来自 Apple 的天气数据的准则和要求。有关详情,请查看下方的归因要求部分。
适用于 WeatherKit 的 Swift API 要求使用 Xcode 14、iOS 16、iPadOS 16、macOS 13、Apple tvOS 16 和 watchOS 9。对于其他平台和网站,你可以使用 REST API。
在实现 WeatherKit 之前,你将需要使用“证书、标识符和描述文件”来设置标识符和密钥。
如果你的 App、网页版 App 或网站会显示来自 Apple 的“天气”App 的任何数据 (除了天气预警或者增值服务或产品之外,如下文所述),则你必须清晰地展示 Apple“天气”商标 (天气) 以及指向其他数据来源的法律链接。
增值服务或产品是指你开发的某些数据、产品和/或服务,它们派生自 Apple 天气数据且经过转化,因此任何用户或其他第三方均无法从中发现、获取、反向工程或以其他方式确认或使用原始的 Apple 天气数据。你同意在显示增值服务或产品时,将数据的来源归因于“天气”,并附上一条提示 Apple 提供的数据已被修改的通知。
对 Dark Sky 天气服务的支持将于 2023 年 3 月 31 日终止。要过渡到 WeatherKit 并继续为你的 App、网页版 App、网站和服务获取天气数据,你需要成为 Apple Developer Program 会员,查看特别注意事项,以及将各字段对应成相应的名字。
如果你是非营利组织、官方认可的教育机构或政府机构,你可能符合申请 Apple Developer Program 会员资格年费豁免的条件。
Dark Sky 栏位 | REST | Swift |
---|---|---|
RESPONSE 格式 | ||
latitude | metadata.latitude | metadata.latitude |
longitude | metadata.longitude | metadata.longitude |
exclude | None | None |
extend=hourly | None | None |
lang=[language] | metadata.language | None |
units=[units] | metadata.units | None |
timezone | None | None |
currently | currentWeather | currentWeather |
minutely | forecastNextHour | minuteForecast |
hourly | forecastHourly | hourlyForecast |
daily | forecastDaily | dailyForecast |
alerts | weatherAlerts | weatherAlerts |
flags | metadata (on each object) | metadata (on each object) |
DATA POINT 对象 | ||
apparentTemperature | temperatureApparent | apparentTemperature |
apparentTemperatureHigh | None | None |
apparentTemperatureHighTime | None | None |
apparentTemperatureLow | None | None |
apparentTemperatureLowTime | None | None |
apparentTemperatureMax | None | None |
apparentTemperatureMaxTime | None | None |
apparentTemperatureMin | None | None |
apparentTemperatureMinTime | None | None |
cloudCover | cloudCover | cloudCover |
dewPoint | temperatureDewPoint | dewpoint |
humidity | humidity | humidity |
icon | conditionCode | condition / symbolName |
moonPhase | moonPhase (daily only) | dailyForecast.moon.phase |
nearestStormBearing | None | None |
nearestStormDistance | None | None |
ozone | None | None |
precipAccumulation | precipitationAmount | precipitationAmount |
precipIntensity | precipitationIntensity | precipitationIntensity |
precipIntensityError | None | None |
precipIntensityMax | None | None |
precipIntensityMaxTime | None | None |
precipProbability | precipitationChance | precipitationChance |
precipType | precipitationType | precipitation |
pressure | pressure | pressure |
summary | None | minuteForecast.summary |
sunriseTime | sunrise, sunriseAstronomical, sunriseCivil, sunriseNautical | sun.sunrise |
sunsetTime | sunset, sunsetAstronomical, sunsetCivil, sunsetNautical | sun.sunset |
temperature | temperature | temperature |
temperatureHigh | None | None |
temperatureHighTime | None | None |
temperatureLow | None | None |
temperatureLowTime | None | None |
temperatureMax | temperatureMax | highTemperature |
temperatureMaxTime | None | None |
temperatureMin | temperatureMin | lowTemperature |
temperatureMinTime | None | None |
time | dailyStart, hourlyStart, forecastStart, startTime | date |
uvIndex | uvIndex | uvIndex |
uvIndexTime | None | None |
visibility | visibility | visibility |
windBearing | windDirection | wind.direction |
windGust | windGust | wind.gust |
windGustTime | None | None |
windSpeed | windSpeed | wind.speed |
DATA BLOCK 对象 | ||
data | dataSets | None |
summary | None | None |
icon | conditionCode | condition / symbolName |
ALERTS 阵列 | ||
description | messages | summary |
expires | expireTime | metadata.expirationDate |
regions | areaId/areaName | region |
severity | severity | severity |
time | issuedTime | metadata.date |
title | description | summary |
uri | detailsUrl | detailsURL |
FLAGS 对象 | ||
nearest-station | None | None |
sources | source | weatherService.attribution |
units | units | None |
RESPONSE HEADERS | ||
Cache-Control | Cache-Control | None |
Expires deprecated | None | None |
X-Forecast-API-Calls | None | None |
X-Response-Time | None | None |