Rork Max で WeatherKit を使う天気アプリ — 認証とアトリビューションの落とし穴

認証は「設定し忘れ」が一番多い

WeatherKit の Swift API は、API キーを直接コードに書きません。代わりに、Apple Developer のアカウントで WeatherKit を有効化し、アプリの Capability に追加することで認証が通ります。Rork Max が生成したプロジェクトをそのまま使う場合、ここが抜けやすい箇所です。実機で空データが返るというトラブルの多くは、コードではなくこの設定漏れが原因でした。

確認すべきは次の三点です。

1. Apple Developer の Identifiers で、アプリの App ID に WeatherKit が有効化されていること
2. プロジェクトの Signing & Capabilities に WeatherKit が追加されていること（Rork Max のクラウドビルドでも内部的に同じ設定が必要です）
3. Info.plist に位置情報の利用目的（NSLocationWhenInUseUsageDescription）が記載されていること

このうち一つでも欠けると、実機では WeatherDaemon 由来のエラーが返り、シミュレータでは動くのに実機で空のデータになる、という分かりにくい症状になります。私は最初、これをコードのバグだと思い込んで半日溶かしました。原因の切り分けに時間がかかったぶん、教訓として深く残っています。本番の実機で空データが返るときは、まず Capability を疑って一つずつ潰すのが、結局いちばん早い解決でした。

審査で必須のアトリビューション

ここが本題です。WeatherKit のデータを使うアプリは、Apple の規約により「データ出典の明記」と「法的リンクへの導線」を画面に表示する義務があります。これを満たさないと、機能が完璧でも審査でリジェクトされます。回避策はなく、正面から実装するしかありません。

具体的には、取得した Weather オブジェクトから attribution を読み出し、ロゴ画像と Apple が指定する法的ページへのリンクを表示します。

import WeatherKit
import SwiftUI
 
struct AttributionView: View {
    let attribution: WeatherAttribution
 
    var body: some View {
        HStack(spacing: 6) {
            AsyncImage(url: attribution.combinedMarkLightURL) { image in
                image.resizable().scaledToFit()
            } placeholder: {
                Color.clear
            }
            .frame(height: 14)
 
            Link(" 天気データについて", destination: attribution.legalPageURL)
                .font(.caption2)
                .foregroundStyle(.secondary)
        }
    }
}

combinedMarkLightURL と combinedMarkDarkURL はライト/ダークで出し分けます。legalPageURL は Apple が用意する出典一覧ページで、自前のページに差し替えてはいけません。私が最初にリジェクトされたのは、ロゴは出していたのに legalPageURL へのリンクを省いていたためでした。「Apple Weather」の文字とリンクの両方が必要だと考えてください。

アトリビューションの取得自体は予報取得と同時に行えます。

let attribution = try await WeatherService.shared.attribution

無駄な呼び出しを減らすキャッシュ

天気は分単位で変わるものではありません。にもかかわらず、画面を開くたびに取得していると、クォータをあっという間に使い切ります。私は「同じ位置・同じ時間帯なら再取得しない」という単純な規則でキャッシュを入れました。

struct CacheEntry {
    let location: CLLocation
    let fetchedAt: Date
    let current: CurrentWeather
}
 
func shouldRefetch(_ entry: CacheEntry?, for location: CLLocation) -> Bool {
    guard let entry else { return true }
    let age = Date().timeIntervalSince(entry.fetchedAt)
    let moved = entry.location.distance(from: location)
    // 15分以上経過、または2km以上移動したら再取得
    return age > 900 || moved > 2000
}

この「15分・2km」という閾値は、天気アプリの体感としてちょうど良い値でした。秒単位で更新しても表示はほとんど変わらないのに、呼び出し回数だけが増えます。実測では、この規則を入れる前後で一日あたりの WeatherKit 呼び出しがおおよそ50%ほど減りました。個人開発で複数のアプリを運用していると、こうした「呼ばない設計」の差が月間クォータに効いてきます。私はこの手の地味な節約を、機能追加と同じくらい大切にしています。

まず確かめてほしいこと

WeatherKit を組み込んだら、公開前に実機で一度だけ確認してください。アトリビューションのロゴとリンクが、ライト・ダーク両方できちんと表示されているか。この一点を満たすだけで、私が二度繰り返したリジェクトは避けられます。機能の実装よりも、規約の一行のほうが公開を左右することがある——天気アプリは、それを静かに教えてくれる題材だと感じています。