About this endpoint
What it does
Returns the 24 unequal planetary hours for a given latitude, longitude, and date, along with the day ruler and the UTC sunrise and sunset times used to divide the day.
Query Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| lat | Number | Yes | Latitude in decimal degrees. Minimum -90, maximum 90. |
| lng | Number | Yes | Longitude in decimal degrees. Minimum -180, maximum 180. |
| date | String | Yes | Date in date format (YYYY-MM-DD). |
Response
Returns a JSON object with lat and lng number fields, a date string field, a day_ruler string field, sunrise_utc and sunset_utc date-time string fields, and an hours array of objects. Each object in hours contains index (integer), period (day or night), ruler (one of the planetary ruler strings), start_utc (date-time string), and end_utc (date-time string).
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| lat | Number | Yes | Latitude in decimal degrees. |
| lng | Number | Yes | Longitude in decimal degrees. |
| date | String | Yes | Date in date format (YYYY-MM-DD). |
| day_ruler | ENUM | Yes | Planetary ruler for the day. Allowed values: Sun, Venus, Mercury, Moon, Saturn, Jupiter, Mars. |
| sunrise_utc | String | Yes | Sunrise time in UTC as a date-time string. |
| sunset_utc | String | Yes | Sunset time in UTC as a date-time string. |
| hours | Object Array | Yes | Array of 24 planetary-hour objects. Each item includes index, period, ruler, start_utc, and end_utc. |