get_solar_eclipse_by_date
Calculate solar eclipse visibility and timing for a specific date and location. Provides detailed phase information including type, magnitude, and duration when visible.
Instructions
Get local solar eclipse circumstances for a specific date and location.
Calculates whether a solar eclipse is visible from a given location on a specific date, and if so, provides detailed timing and positional information for all eclipse phases.
Args: date: Date of the eclipse in YYYY-MM-DD format. Valid range: 1800-01-01 to 2050-12-31 latitude: Observer's latitude in decimal degrees (-90 to 90) longitude: Observer's longitude in decimal degrees (-180 to 180) height: Observer's height above mean sea level in meters. Default is 0. Range: -200 to 10000 meters.
Returns: SolarEclipseByDateResponse: GeoJSON Feature with eclipse type, magnitude, obscuration, duration, and local circumstances.
Tips for LLMs: - If description is "No Eclipse at this Location", the eclipse isn't visible here - magnitude >= 1.0 indicates total eclipse; < 1.0 is partial - altitude must be > 0 for eclipse to be visible (sun above horizon) - Use get_solar_eclipses_by_year first to find eclipse dates
Example: eclipse = await get_solar_eclipse_by_date( date="2017-8-21", latitude=46.67, longitude=-122.65, height=15 ) print(f"Eclipse type: {eclipse.properties.description}")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | ||
| latitude | Yes | ||
| longitude | Yes | ||
| height | No |