Solar Position & Day Length Oracle

Use this endpoint when you need structured solar position metrics (sunrise, sunset, declination, day-of-year) for a named city without providing coordinates yourself — it handles geocoding internally. Prefer this over generic weather APIs when the specific output needed is solar timing and astronomical data rather than temperature or precipitation forecasts.

• City name not recognized or geocoding fails — returns error or empty result
• Missing required 'city' query parameter — returns validation error
• Ambiguous city name with multiple matches — may return data for the most populous match
• Network timeout or upstream geocoding service unavailable