NOAA

🚀 NOAA Tides and Currents API Documentation

The NOAA Tides & Currents API offers the following data and services:

• Tide Predictions: Obtain tide schedules and height predictions for specific locations.
• Current Predictions: Get real - time or historical current speed and direction data for specified positions.
• Real - Time Observations: Access the latest ocean condition data from NOAA's ocean sensors.
• Sunrise and Sunset Times: Calculate the times of sunrise, sunset, and other solar events for a specific date and geographical location.
• Lunar Phase Information: Retrieve lunar phase stages within a specific date range.
• Solar Position: Find out the solar position information for a specific time and place.

📚 API Endpoints

💡 Tide Predictions API

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

📋 Request Parameters

📤 Response Format

[
  {
    "time": "string", // Timestamp (ISO 8601 format)
    "height": number, // Tide height
    "direction": number, // Current direction (degrees)
    "speed": number // Current speed (knots)
  }
]

🌟 Real - Time Observations API

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

📋 Request Parameters

📤 Response Format

[
  {
    "time": "string", // Timestamp (ISO 8601 format)
    "height": number, // Tide height
    "waterTemp": number, // Water temperature (Celsius)
    "airTemp": number, // Air temperature (Celsius)
    "windSpeed": number, // Wind speed (knots)
    "windDirection": number // Wind direction (degrees)
  }
]

🌞 Sunrise and Sunset Times API

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

📋 Request Parameters

📤 Response Format

{
  "sunrise": "string", // Sunrise time (ISO 8601 format)
  "sunset": "string", // Sunset time (ISO 8601 format)
  "moonrise": "string", // Moonrise time (ISO 8601 format)
  "moonset": "string" // Moonset time (ISO 8601 format)
}

📄 API Documentation Links

• Tide Predictions Documentation: Tide Predictions
• Current Predictions Documentation: Current Predictions
• Real - Time Observations Documentation: Real - Time Observations

🛠️ Third - Party Tools

• Tide Charts: Generate visual tide charts Link
• Current Mapper: Current visualization tool Link

🚧 Development Guide

🔑 How to Use the API Key

1. Register a NOAA account: Registration Page
2. Apply for an API access key: Application Page
3. Add the key to your code:

const api_key = 'your_api_key_here';

💻 Example Code

📊 Get Tide Predictions

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

🌊 Get Real - Time Observations

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

📚 Other Resources

• NOAA Official Website: NOAA Homepage
• Developer Forum: Developer Community

⚠️ Notes

• API Request Limit: A maximum of 1000 requests per day.
• Data Delay: Real - time observation data may have a delay of 15 minutes to 1 hour.
• Error Range: Tide and current prediction results may be affected by weather conditions and have certain errors.

🚀 Quick Start

Step 1: Register a NOAA Account

Visit the NOAA official website, register and log in to your account.

Step 2: Get an API Key

Go to the API access page, apply for API usage permission and obtain the key.

Step 3: Start Calling the API

Use the obtained key and start calling the NOAA Tides and Currents API according to the example code in the documentation.