WeatherKitの利用開始
WeatherKitは、まったく新しいApple Weatherサービス と連携して、Appやサービスに有益な気象データを幅広く提供することで、ユーザーが最新情報を確認し、身を守り、備えるのをサポートすることができます。WeatherKitは現在ベータ版で、Apple Developer Programのメンバーに提供されています。このページでは、WeatherKitの利用要件、使い始めるためのツール、Dark Skyの気象サービスからの移行方法を紹介します。
利用要件
Apple Developer Programのメンバーシップ
WeatherKitのベータ版へのアクセス権はApple Developer Programに含まれています。このプログラムでは、Appの開発と配信に必要なすべてのツール、リソース、サポートが提供されており、ベータ版ソフトウェア、Appサービス、テストツール、Appアナリティクスなども用意されています。
ソフトウェア
WeatherKitの利用には、iOS 16、iPadOS 16、macOS 13、tvOS 16、watchOS 9が必要です。Webサイトやその他のプラットフォームについては、REST APIを使用できます。
価格および提供について
WeatherKitのベータ版では、1つのApple Developer Programメンバーシップにつき、APIを毎月最大500,000回呼び出すことができます。WeatherKitがベータ版でなくなった後も、メンバーシップには引き続き毎月500,000回のAPI呼び出しが含まれます。API呼び出しの回数がさらに必要な場合は、月間サブスクリプションプランを購入できるようになる予定です。
- 500,000回の呼び出し／月：メンバーシップに含まれる
- 100万回の呼び出し／月：49.99米ドル
- 200万回の呼び出し／月：99.99米ドル
- 500万回の呼び出し／月：249.99米ドル
- 1,000万回の呼び出し／月：499.99米ドル
- 2,000万回の呼び出し／月：999.99米ドル
サブスクリプションの登録方法に関する詳細情報は、今年の夏にお知らせします。
アトリビューションの要件
App、Web App、WebサイトでWeatherKitを使用する際は、Appleの気象データのアトリビューションに関するガイドラインと要件に従う必要があります。詳細については、アトリビューションの要件に関する以下のセクションを参照してください。
ツールとドキュメント
XcodeとSDK
WeatherKit向けのSwift APIを利用するには、Xcode 14、iOS 16、iPadOS 16、macOS 13、tvOS 16、watchOS 9のベータ版が必要です。その他のプラットフォームやWebサイトについては、REST APIを使用できます。最新のベータ版をダウンロードし、以下のリソースを活用して、WeatherKitをAppに実装しましょう。
サービスIDと鍵の設定
WeatherKitを実装するには、まず「Certificates, Identifiers & Profiles（証明書、ID、プロファイル）」でIDと鍵を設定する必要があります。
ビデオとドキュメント
Apple Weatherとサードパーティのアトリビューション
App、Web App、WebサイトにAppleの気象データを表示する場合（以下に示す、気象警報や付加価値サービス／付加価値製品以外の場合）は、Apple Weatherの商標（Weather）と、その他のデータソースへの法的リンクを明示する必要があります。
気象警報
- 表示されるすべての気象警報に、Appleがデベロッパに提供するAppleの気象警報情報のページへのリンクを埋め込む必要があります。
- すべての気象警報のタイトルと説明文に、その警報を発表した気象庁の正式名称を含める必要があります。該当する気象庁、およびこうした気象警報の利用と配信に適用されるライセンス条項についての詳細情報は、Appleの気象警報情報のページで確認してください。
- 重大な気象警報の文面は、いかなる形でも修正、変更、改変、不明瞭化しないでください。
付加価値サービスまたは付加価値製品
付加価値サービスまたは付加価値製品とは、デベロッパが開発したデータ、製品、またはサービスのうち、Appleの気象データに由来し、そのデータを変換することによって、ユーザーまたは別のサードパーティが元のAppleの気象データを特定、アクセス、リバースエンジニアリングできないようにしたり、その他の方法で解明もしくは使用したりできないようにしたものを意味します。付加価値サービスまたは付加価値製品を提供する場合、デベロッパは、データソースがWeatherであることと、Appleが提供するデータを変換して利用しているという注記を明示することに同意するものとします。
Dark Skyからの移行
Dark Skyの気象サービスのサポートは2023年3月31日に終了します。WeatherKitに移行して、App、Web App、Webサイト、サービスで引き続き気象データにアクセスするには、Apple Developer Programのメンバーシップが必要です。また、注意事項を確認し、フィールドを該当するものにマッピングする必要があります。
非営利団体、認定を受けた教育機関、政府機関は、Apple Developer Programのメンバーシップ登録料免除の対象となる場合があります。
重要な更新情報
- 毎日のデータとは、その暦日中に発生したすべてのデータです。たとえば、7月1日は午前12時から始まり、午後11時59分に終わります。
- 日中の最高体感温度と、夜間の最低体感温度は提供されなくなります。
- 特定の場所でどのデータセットや機能が利用できるかについては、WeatherKitのavailabilityエンドポイントを使用して確認できます。
- Dark Sky Time Machineの機能は、時間別および日付別の気象リクエストに組み込まれています。
フィールドのマッピング
| Dark Skyのフィールド | REST | Swift |
|---|---|---|
| レスポンスフォーマット | ||
| 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) |
| データ ポイント オブジェクト | ||
| 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 | dataSets | None |
| summary | None | None |
| icon | conditionCode | condition / symbolName |
| アラートの配列 | ||
| description | messages | summary |
| expires | expireTime | metadata.expirationDate |
| regions | areaId/areaName | region |
| severity | severity | severity |
| time | issuedTime | metadata.date |
| title | description | summary |
| uri | detailsUrl | detailsURL |
| フラグ オブジェクト | ||
| nearest-station | None | None |
| sources | source | weatherService.attribution |
| units | units | None |
| レスポンスヘッダ | ||
| Cache-Control | Cache-Control | None |
| Expires deprecated | None | None |
| X-Forecast-API-Calls | None | None |
| X-Response-Time | None | None |
サポートおよびお問い合わせ
Apple Developer Forum
質問を投稿したり、ほかのデベロッパやAppleのエンジニアと技術的な情報を交換したりできます。
フィードバックアシスタント
バグレポートを送信したり、APIやデベロッパツールの改善をリクエストしたりすることができます。
Apple Developer Support
ご質問があれば、Apple Developer Supportまでお問い合わせください。ご不明な点について、Apple Developer Supportが電話またはEメールでお答えします。