The sky on a day
get_occasion_skyShows the sky on a day that matters to the person: a wedding, anniversary, birthday, a new home or another occasion. It gives the Sun and Moon signs, the Moon's phase, any retrograde planets, a card title and short lines they can use, and, with a place, sunset, golden hour, dusk, the Moon and the planets visible that evening. It needs the date; add the local time, the place's time zone and its coordinates if the person gives them. It also rates the date from 0 to 100 with a verdict and the astrological reasons (Venus, the Moon's phase and sign, retrograde planets); share the rating and its reasons plainly. When asked for the best days for an occasion, give the window as searchFrom and searchTo (up to 92 days, such as a whole month); it rates every day in it and returns the three best-rated days with their reasons, and the card for the best one unless a date is also given. When asked which of a few named dates is best, call it for each date and compare the ratings. It never guarantees how the day will go. For the printable card, copy the returned cardUrl exactly, including every field after #; do not reconstruct it from the conversation. If cardUrl is null, use the returned page link. If they want to share the rating, give them the returned shareUrl exactly.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | The day, such as 2027-06-12 (years 1800–2199). Needed unless searchFrom and searchTo are given. | |
| time | No | The local clock time, such as 19:00, if the person gives one. Needs zone. | |
| zone | No | The place's time zone, such as Europe/Rome. Needed with a time or a place. | |
| names | No | Optional: up to two first names to print on the card, only if the person asks for them. Display only, not stored. | |
| place | No | Optional place name printed on the card, such as Florence, Italy. Display only: it is not used in the calculation and is not stored. | |
| latitude | No | Optional. The place's latitude, used only to work out sunset, golden hour and the evening sky there. Give it with longitude and zone. Nothing is stored. | |
| occasion | Yes | What the day is: wedding, anniversary, met (the day they met), birthday, pet, home, job, graduation, retirement or gathering. | |
| searchTo | No | The last day of the window to search, such as 2027-06-30, at most 92 days after searchFrom counting both days. Every day is rated and the three best come back. | |
| longitude | No | Optional. The place's longitude, with latitude, for the evening sky. Nothing is stored. | |
| searchFrom | No | To find the best days: the first day of the window to search, such as 2027-06-01. Give it with searchTo. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||