meridianドキュメント
ダッシュボード、購読、APIの動作に関するガイド。
はじめに
meridian は複数の場所を一度に見られる天気ダッシュボードです。都市を検索し、そのページを開き、「あなたの場所」にピン留めして、気温・天候・短期予報を確認できます。アカウントは不要です。ピン留めした都市とほとんどの設定はこの端末に保存されます。
ダッシュボード
上から順に: 1. ヒーロー — 歓迎文、検索、現在地のクイック天気確認。 2. あなたの場所 — ピン留めした場所の天気カード。 3. 近くと人気 — 2列:「お近く」と「人気の検索」。 4. 「あなたの場所」下のダッシュボード広告(プレースホルダーまたは AdSense)。 5. Journal — 記事カルーセル。 NEXT_PUBLIC_SHOW_HOME_STRETCH=0 で広告と Journal を非表示にできます。
都市詳細
検索結果とホームのカードからその場所のページが開きます。閲覧のためにピン留めは不要です。ピン留めはホームの「あなたの場所」に追加するだけです。いくつかのショーケース都市とサイトが既知の場所は常に開きます。未知の住所は案内付きの空状態または 404 です。
購読
ログインなしで meridian にメール送信を依頼できます。製品ニュースレター、ピン留め都市の週次ダイジェスト、条件が合ったときの天気アラートから選べます。すべてオプトイン。各メールに停止方法があります。
収益化と同意
meridian は無料の天気サイトとして動作します。広告を外す有効な Premium 決済や有料プランはありません。広告は広告同意を許可し、運営者が Google AdSense を設定した場合のみ表示されます。
天気アイコン
カードと予報の天気画像は、はっきりした線/塗りつぶしアイコン(Bas Milius の Meteocons、MIT ライセンス)です。晴れ、曇り、雨、雪、霧などを文字説明の横に示します — 画像が読み込めなくても意味はテキストが担います。
近くと人気
「あなたの場所」の下に、ホームには短い場所リストが2列あります。 お近く — 自宅や地域近くの提案場所とライブ天候。検索したすべての私的ログではありません。 人気の検索 — このサイトでよく検索される場所。これもサイト全体の話で、「個人の履歴」ではありません。
予報とキャッシュ
一般訪問者はスキップして構いません。meridian を運用・統合する人向けに、天気データの保存と更新の仕組みを説明します。平易に言うと:ブラウザは直近の読み取りを覚え、サーバーも共有読み取りを覚えるので、クリックのたびに天気プロバイダーを呼びません。
API制限
サイト運営者向けです。閲覧された天気データは共有・キャッシュ向きにし、OpenWeather 無料枠(既定1000回/日)の消費を抑えます。
APIリファレンス
meridian API を統合する開発者・運営者向け — 一般訪問者はスキップ可。全 API ルートは src/app/api/ 下の Next.js App Router ハンドラ。天気と geocode は OPENWEATHER_API_KEY 必須。Cron ルートは Authorization: Bearer CRON_SECRET。管理ルートは /login 後の認証済み管理セッション cookie(meridian_admin_session)、開発時は ALLOW_DEV_ADMIN_BYPASS を除く。
デプロイと環境
meridian をデプロイする人向け。一般訪問者には不要な設定です。動作デモには OPENWEATHER_API_KEY のみ;それ以外は任意の stretch。