orthogonal-sh/weather-forecast

Weather Forecast

Get weather forecasts including temperature, precipitation, wind, and humidity for any location.

When to Use

• User asks about weather
• User wants to know if it will rain
• User asks "what's the weather in [location]?"
• Planning outdoor activities
• Travel weather checks

How It Works

Uses the Precip API to get weather data from meteorological sources.

Usage

Get Daily Forecast

orth run precip /api/v1/daily -q 'latitude=37.7749&longitude=-122.4194&start=2026-02-14&end=2026-02-21'

<details> <summary>curl equivalent</summary>

curl -X POST "https://api.orth.sh/v1/run" \
  -H "Authorization: Bearer $ORTHOGONAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"precip","path":"/api/v1/daily","query":{"latitude":"37.7749","longitude":"-122.4194","start":"2026-02-14","end":"2026-02-21"}}'

</details>

Get Hourly Forecast

orth run precip /api/v1/hourly -q 'latitude=37.7749&longitude=-122.4194&start=2026-02-14&end=2026-02-15'

Get Temperature by Hour

orth run precip /api/v1/temperature-hourly -q 'latitude=37.7749&longitude=-122.4194&start=2026-02-14&end=2026-02-15'

Get Recent Rain Data

orth run precip /api/v1/recent-rain -q 'latitude=37.7749&longitude=-122.4194'

Get Last 48 Hours

orth run precip /api/v1/last-48 -q 'latitude=37.7749&longitude=-122.4194'

Parameters

• latitude (required) - Latitude (e.g., 37.7749)
• longitude (required) - Longitude (e.g., -122.4194)
• start (required for forecasts) - Start date (YYYY-MM-DD format)
• end (required for forecasts) - End date (YYYY-MM-DD format)

Common Coordinates

• San Francisco: latitude=37.7749, longitude=-122.4194
• New York: latitude=40.7128, longitude=-74.0060
• Los Angeles: latitude=34.0522, longitude=-118.2437
• London: latitude=51.5074, longitude=-0.1278
• Tokyo: latitude=35.6762, longitude=139.6503

Response

All endpoints return GeoJSON FeatureCollection with coordinates in geometry and weather data in properties.

/api/v1/daily — properties.days[] array

• precip (number) - Total precipitation in mm
• rain / snow (number) - Rain and snow amounts in mm
• precip_probability (number|null) - Probability 0-100 (null for observations)
• precip_type (string) - rain, snow, sleet, or freezing_rain
• startTime (string) - ISO 8601 timestamp
• source (string) - observation or forecast

/api/v1/hourly — properties.hours[] array

Same fields as daily, plus:

• slr (number) - Snow-to-liquid ratio

/api/v1/temperature-hourly — properties.hours[] array

• temperature (number) - Temperature in °C
• startTime (string) - ISO 8601 timestamp

/api/v1/recent-rain — properties (single object)

• precip (number) - Total precipitation in mm
• rain / snow / sleet / freezing_rain (number) - Breakdown by type in mm
• precip_type (string) - Dominant precipitation type
• startTime / endTime (string) - Time window of the observation
• ago (string) - Human-readable time since last data (e.g., "2 hours")
• details (string) - Data freshness note

/api/v1/last-48 — properties (single object)

• precip (number) - Total precipitation in last 48 hours in mm
• rain / snow / sleet / freezing_rain (number) - Breakdown by type in mm
• precip_type (string) - Dominant precipitation type
• slr (number) - Snow-to-liquid ratio
• endTime (string) - End of the 48-hour window

Examples

User: "What's the weather in San Francisco this week?"

orth run precip /api/v1/daily -q 'latitude=37.7749&longitude=-122.4194&start=2026-02-14&end=2026-02-21'

User: "Will it rain in NYC tomorrow?"

orth run precip /api/v1/hourly -q 'latitude=40.7128&longitude=-74.0060&start=2026-02-15&end=2026-02-16'

User: "How much rain fell in Seattle recently?"

orth run precip /api/v1/recent-rain -q 'latitude=47.6062&longitude=-122.3321'

Error Handling

• 400 - Missing required parameters (latitude, longitude, or date range for daily/hourly)
• 422 - Invalid date format — must be YYYY-MM-DD
• precip_probability: null means the data is from observations, not forecasts
• source: "observation" = historical data; source: "forecast" = predicted
• All precipitation values are in millimeters (mm), temperatures in Celsius (°C)

Tips

• Convert city names to coordinates before calling
• Use current date for start, add days for end
• Date format must be YYYY-MM-DD
• recent-rain and last-48 don't need date parameters