NOAA

🚀 NOAA 潮汐と海流 API ドキュメント

NOAA 潮汐と海流 (Tides & Currents) API は、以下のデータとサービスを提供します。これらのサービスを通じて、海洋関連のさまざまな情報を取得できます。

• 潮汐予測：特定の場所の潮汐の予定表と高さの予測を取得します。
• 海流予測：指定された位置のリアルタイムまたは過去の海流の速度と方向のデータを取得します。
• リアルタイム観測：NOAA の海洋センサーからの最新の海洋状況データにアクセスします。
• 日の出・日の入り時間：特定の日付と地理位置における日の出、日の入り、その他の太陽イベントの時間を計算します。
• 月相情報：特定の日付範囲内の月相の段階を取得します。
• 太陽位置：特定の時間と場所における太陽の位置情報を取得します。

📚 API エンドポイント

潮汐予測 API

https://api.tidesandcurrents.noaa.gov/ltl TidePredictions

リクエストパラメータ

レスポンス形式

[
  {
    "time": "string", // タイムスタンプ（ISO 8601 形式）
    "height": number, // 潮汐の高さ
    "direction": number, // 海流の方向（度）
    "speed": number // 海流の速度（ノット）
  }
]

リアルタイム観測 API

https://api.tidesandcurrents.noaa.gov/obs Observations

リクエストパラメータ

レスポンス形式

[
  {
    "time": "string", // タイムスタンプ（ISO 8601 形式）
    "height": number, // 潮汐の高さ
    "waterTemp": number, // 水温（摂氏度）
    "airTemp": number, // 気温（摂氏度）
    "windSpeed": number, // 風速（ノット）
    "windDirection": number // 風向（度）
  }
]

日の出・日の入り時間 API

https://api.tidesandcurrents.noaa.gov/api/prod/sun SunTimes

リクエストパラメータ

レスポンス形式

{
  "sunrise": "string", // 日の出時間（ISO 8601 形式）
  "sunset": "string", // 日の入り時間（ISO 8601 形式）
  "moonrise": "string", // 月の出時間（ISO 8601 形式）
  "moonset": "string" // 月の入り時間（ISO 8601 形式）
}

📄 API ドキュメントリンク

• 潮汐予測ドキュメント：Tide Predictions
• 海流予測ドキュメント：Current Predictions
• リアルタイム観測ドキュメント：Real-Time Observations

🛠️ サードパーティツール

• Tide Charts：可視化された潮汐チャートを生成します リンク
• Current Mapper：海流を可視化するツールです リンク

📖 開発ガイド

API キーの使用方法

1. NOAA アカウントを登録します：登録ページ
2. API アクセスキーを申請します：申請ページ
3. コードにキーを追加します：

const api_key = 'your_api_key_here';

サンプルコード

潮汐予測の取得

fetch(`https://api.tidesandcurrents.noaa.gov/ltl?station=9412100&beginDate=${startDate}&endDate=${endDate}&interval=60&units=ft&apikey=${api_key}`)
  .then(response => response.json())
  .then(data => console.log(data));

リアルタイム観測の取得

fetch(`https://api.tidesandcurrents.noaa.gov/obs?station=9412100&beginDate=${startDate}&endDate=${endDate}&apikey=${api_key}`)
  .then(response => response.json())
  .then(data => console.log(data));

📚 その他のリソース

• NOAA 公式ウェブサイト：NOAA ホームページ
• 開発者フォーラム：開発者コミュニティ

⚠️ 注意事項

• API リクエスト回数制限：1 日あたり最大 1000 回のリクエストが可能です。
• データ遅延：リアルタイム観測データには 15 分から 1 時間の遅延がある場合があります。
• 誤差範囲：潮汐と海流の予測結果は天候条件の影響を受け、一定の誤差がある可能性があります。

🚀 クイックスタート

ステップ 1: NOAA アカウントを登録する

NOAA 公式サイトにアクセスし、アカウントを登録してログインします。

ステップ 2: API キーを取得する

API アクセスページにアクセスし、API の使用権限を申請してキーを取得します。

ステップ 3: API の呼び出しを開始する

取得したキーを使用して、ドキュメント内のサンプルコードに従って、NOAA の潮汐と海流 API の呼び出しを開始します。