Plan golden hour shoot
plan_golden_hour_shootRead-only
Use this when the user wants photography golden hour shoot windows for a city and a date range, with an ICS calendar file and CSV table. Choose morning, evening or both. Limits: 1–31 days, cities with population 50,000+ (plus Tromso), years 1900–2100, flat sea-level horizon; missing polar windows are reported and calendar events are only included for existing windows. Does not access or change a calendar.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | City name, for example New York. Cities with population 50,000+ are supported; the largest same-name match is used. | |
| days | Yes | Number of consecutive days, 1 to 31, for example 7. | |
| state | No | Optional US state name or abbreviation, for example NY or New York. | |
| period | Yes | Light windows to include, for example evening. A continuous window includes both periods. | |
| country | No | Optional country name or two-letter code to narrow the match, for example US. | |
| start_date | Yes | First local date in YYYY-MM-DD, for example 2026-10-12. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| blue | No | ||
| date | No | ||
| days | No | ||
| mode | Yes | ||
| civil | No | ||
| golden | No | ||
| period | No | ||
| sunset | No | ||
| values | No | ||
| changes | No | ||
| preview | No | ||
| request | Yes | ||
| sunrise | No | ||
| location | Yes | ||
| nautical | No | ||
| timeZone | No | ||
| dayLength | No | ||
| dayStatus | No | ||
| downloads | No | ||
| solarNoon | No | ||
| startDate | No | ||
| eventCount | No | ||
| definitions | Yes | ||
| limitations | Yes | ||
| astronomical | No | ||
| sunsetAzimuth | No | ||
| sunriseAzimuth | No | ||
| dayLengthSeconds | No |