Introducing the New Maritime API

AerisWeather is excited to announce the launch of our new maritime API endpoint, designed to provide essential global marine weather data. This new maritime endpoint is accessible via the AerisWeather API and is available to all Flex subscribers. Data from this comprehensive set is available hourly by default, with options for 3-hour, 6-hour, or other defined intervals. It is suitable for various maritime applications, such as oceanic navigation, offshore operations, coastal monitoring, and recreational activities.

New Maritime API Data

The maritime endpoint provides access to a wide array of information, including sea surface temperature, sea current direction and speed, significant wave height, primary wave direction and period, wind wave height, direction, and period, primary swell wave height, direction, and period, secondary swell wave height, direction, and period, and tertiary swell wave height, direction, and period.

These data attributes are crucial for maritime activities, as they may affect a vessel’s stability, maneuverability, safety, route planning, and fuel consumption management. By understanding these factors, mariners can avoid areas with unfavorable conditions and plan safer routes.

Use Cases for the New Maritime Endpoint Attributes

1. Oceanic Navigation: Mariners can use the Maritime endpoint data to plan efficient routes that take advantage of favorable currents and avoid extreme weather conditions, ensuring the safety of the vessel and the crew.
2. Offshore Operations: Offshore platforms, such as oil rigs and wind farms, can use the Maritime endpoint data to plan maintenance activities and manage resources more effectively, minimizing downtime and improving safety.
3. Coastal Monitoring and Recreational Activities: Coastal authorities and recreational users, such as surfers and boaters, can use the Maritime endpoint data to monitor coastal conditions, predict potential hazards, and plan activities accordingly.

Querying the Endpoint:

Example 1: To get the maritime forecast in hourly intervals for the next 24 hours for latitude/longitude 0,0, use the following query:

https://api.aerisapi.com/maritime/0,0?client_id=[ID]&client_secret=[SECRET]

Example 2: To get the maritime forecast in 6-hour intervals for the next seven days for latitude/longitude 0,0, use the following query:

https://api.aerisapi.com/maritime/0,0?for=now&to=+1week&filter=6hours&client_id=[ID]&client_secret=[SECRET]

Python Example

The following Python example demonstrates how to query the maritime endpoint and store the forecast data in a pandas DataFrame:

import requests
import pandas as pd

# Replace with your API credentials
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"

# Query the Maritime endpoint
url = f"https://api.aerisapi.com/maritime/0,0?client_id={client_id}&client_secret={client_secret}"
response = requests.get(url)
data = response.json()

# Extract the forecast data and store it in a pandas DataFrame
forecast_data = data["response"]["periods"]
df = pd.DataFrame(forecast_data)

# Print the DataFrame
print(df)

Start Using the Maritime Endpoint Today

If you’re ready to take advantage of the new maritime endpoint, sign up for a free trial or a Flex account today and use this powerful tool to enhance your maritime operations and activities. The endpoint is currently in beta, so there may be occasional errors and/or changes to the supported features and response output before its production version. However, we’re confident this new offering will provide valuable insights and benefits for all users.

Share this post: