NOAA

🚀 NOAA 潮汐與海流 API 文檔

NOAA 潮汐與海流 API 為用戶提供了豐富的海洋數據和服務，涵蓋潮汐預測、海流預測、即時觀測等多個方面，能幫助用戶更好地瞭解海洋狀況。

🚀 快速開始

步驟 1: 註冊 NOAA 賬戶

訪問 NOAA 官網，註冊並登錄賬戶。

步驟 2: 獲取 API 密鑰

進入 API 訪問頁面，申請 API 使用權限並獲取密鑰。

步驟 3: 開始調用 API

使用獲取到的密鑰，按照文檔中的示例代碼開始調用 NOAA 的潮汐和海流 API。

✨ 主要特性

NOAA 潮汐與海流 (Tides & Currents) API 提供了以下數據和服務：

• 潮汐預測：獲取特定地點的潮汐時間表和高度預測。
• 海流預測：獲得指定位置的即時或歷史海流速度和方向數據。
• 即時觀測：訪問來自 NOAA 海洋傳感器的最新海洋條件數據。
• 日出日落時間：計算特定日期和地理位置的日出、日落及其他太陽事件的時間。
• 月相信息：獲取特定日期範圍內的月相階段。
• 太陽位置：瞭解特定時間和地點的太陽位置信息。

📦 安裝指南

此 API 無需安裝，只需按照快速開始的步驟獲取 API 密鑰，即可開始調用。

💻 使用示例

基礎用法

獲取潮汐預測

// 獲取潮汐預測示例代碼
const api_key = 'your_api_key_here';
const startDate = 'your_start_date';
const endDate = 'your_end_date';
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));

獲取即時觀測

// 獲取即時觀測示例代碼
const api_key = 'your_api_key_here';
const startDate = 'your_start_date';
const endDate = 'your_end_date';
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));

📚 詳細文檔

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';

其他資源

• NOAA 官方網站：NOAA 主頁
• 開發者論壇：開發者社區

🔧 技術細節

此 API 主要基於 NOAA 的海洋傳感器收集數據，並通過網絡接口將數據提供給用戶。潮汐和海流預測是基於歷史數據和數學模型進行計算的，但由於天氣等因素的影響，預測結果可能存在一定誤差。

📄 許可證

文檔中未提及相關許可證信息。

⚠️ 重要提示

• API 請求次數限制：每天最多 1000 次請求。
• 數據延遲：即時觀測數據可能存在 15 分鐘至 1 小時的延遲。
• 誤差範圍：潮汐和海流預測結果可能受天氣條件影響，存在一定誤差。