Skip to main contentWindy Weather
This guide explains how to integrate Windy API into your superun application. The integration uses edge functions to securely proxy all API requests, ensuring your API key never reaches the client.
Documentation
For more details about Windy APIs, refer to the official documentation:
Environment Variables
Add the following environment variables to your supabase secrets, the plugin_secret_prefix MUST be SUPERUN:
WINDY_POINT_FORECAST_KEY - Windy Point Forecast API KeyWINDY_MAP_FORECAST_KEY - Windy Map Forecast API KeyWINDY_WEBCAMS_KEY - Windy Webcams API Key
Step 1: Create Edge Function
Create a Supabase Edge Function to securely proxy Windy API requests. This example demonstrates how to handle different Windy API endpoints:
point forecast
Map forecast
Webcams api
Step 2: Frontend Integration
Call the edge function directly from your frontend. The API key stays secure on the server:
API Features
Windy API provides access to three main services:
Point Forecast API
- Real-time weather conditions for specific coordinates
- Multi-day forecasts (up to 10 days)
- Multiple weather parameters (temperature, wind speed, precipitation, etc.)
- High-resolution weather data (up to 1km resolution)
Map Forecast API
- Weather data visualization for map overlays
- Multiple data sources (ECMWF, GFS, etc.)
- Customizable parameters and models
- Regional and global coverage
Webcams API
- Nearby webcam locations for visual weather verification
- Real-time camera feeds
- Location-based search with radius filtering
- Weather condition validation
Usage Guidelines
When using Windy API:
- Respect rate limits and usage quotas
- Cache weather data appropriately to reduce API calls
- Handle errors gracefully and provide fallback data when available
