{"uid":"cap_xZ-gF-xiqL_EZw2Nd7aeP","slug":"solar-shadow-simulator-e6f38cb4","name":"Solar Shadow Simulator","description":"Pure astronomy and geometry on level ground: sun position by the NOAA method, shadow length as object height divided by the tangent of the sun elevation. Refraction is only applied to sunrise and sunset. Terrain slope, surrounding buildings, vegetation and diffuse light are not modelled, so a point outside the shadow can still be shaded in reality. Times are UTC.","url":"https://solar.halowerk.com/shadow-simulator","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lat":{"type":"number","maximum":90,"minimum":-90},"lon":{"type":"number","maximum":180,"minimum":-180},"date":{"type":"string","description":"Day as YYYY-MM-DD."},"step_minutes":{"type":"integer","default":30,"maximum":60,"minimum":5},"object_height_m":{"type":"number","maximum":1000,"minimum":0.01},"max_shadow_length_m":{"type":"number","default":500,"maximum":100000,"minimum":1,"description":"Shadow lengths above this are reported as capped."},"obstacle_distance_m":{"type":"number","maximum":10000,"minimum":0.01,"description":"Distance of the point of interest from the object."},"obstacle_bearing_deg":{"type":"number","maximum":360,"minimum":0,"description":"Compass bearing from the object to that point."},"bearing_tolerance_deg":{"type":"number","default":10,"maximum":90,"minimum":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xDqhKr_7vYN4k6kTA6TwI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates sun position and shadow length for a vertical object at a given location, date, and time interval using the NOAA astronomical method, and reports whether a specified nearby point falls in shadow.","exampleAgentPrompt":"For our construction site at 48.8566° N, 2.3522° E, simulate the shadow cast by a 15-meter-tall crane on June 21, checking every 30 minutes, and tell me whether a point 40 meters away at bearing 270° falls in shadow at any point during the day.","exampleUseCases":[{"title":"Garden shading from neighbor's fence","prompt":"My garden is at 51.5074° N, 0.1278° W. There's a 2-meter fence 5 meters away at a bearing of 180°. Can you simulate the shadow on July 15 in 30-minute steps and tell me when, if ever, my garden spot falls in the fence's shadow?"},{"title":"Urban courtyard shadow planning","prompt":"We're designing a courtyard in Barcelona at 41.3851° N, 2.1734° E. The adjacent building is 20 meters tall. Check every 15 minutes on December 21 whether a seating area 10 meters away at bearing 90° will be in shadow — we want to know how many hours of direct sun it gets."},{"title":"Solar panel shading assessment","prompt":"I have a solar panel array at 37.7749° N, 122.4194° W that could be shaded by a 8-meter tree 12 meters away at bearing 200°. Run a shadow simulation for March 20 in 30-minute steps so I can see how long and when the shadow might reach the panels."}],"resultDescription":"Returns a time series of shadow calculations at the requested step interval throughout the day (UTC). Each entry includes the UTC timestamp, sun elevation angle, sun azimuth, shadow length in meters (capped at max_shadow_length_m if very long or sun below horizon), and — when obstacle_distance_m and obstacle_bearing_deg are provided — a boolean indicating whether the specified point falls within the shadow cone given the bearing tolerance.","failureModes":["Invalid latitude/longitude values outside ±90/±180 range returns validation error","Date string not in YYYY-MM-DD format causes parse error","object_height_m below 0.01 or above 1000 returns out-of-range error","step_minutes outside 5–60 range rejected","obstacle_bearing_deg outside 0–360 rejected","All shadow lengths reported as capped if sun remains very low (polar winter) or object is very tall","Result is purely geometric — real-world shading may differ due to terrain, buildings, vegetation not modelled"],"whenToPreferThis":"Use this endpoint when you need precise NOAA-method astronomical shadow length and position calculations for a vertical object at a known GPS coordinate and date. It is ideal for architectural planning, garden or solar panel shading assessments, and any use case requiring time-series shadow data throughout a day. Prefer this over general solar irradiance endpoints when the key question is whether a specific point will be in shadow, not how much energy is available. Note it does not model terrain slope, surrounding obstructions, or diffuse light — for complex 3D urban shadow modeling, a full ray-tracing tool would be needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:31:20.194Z","isFirstParty":false}