{"title":"Planetary Return Chart","fields":[{"key":"birthDate","name":"birthDate","kind":"date","required":true,"description":"Original birth date in YYYY-MM-DD format. Used to determine the natal longitude of the selected planet.","example":"1990-07-15"},{"key":"birthTime","name":"birthTime","kind":"time","required":true,"description":"Original birth time in 24-hour HH:MM:SS format. Determines exact natal planet position for return timing.","example":"14:30:00"},{"key":"planet","name":"planet","kind":"tiles","required":true,"description":"Planet for the return calculation. Supports Mercury (~88 days), Venus (~225 days), Mars (~687 days), Jupiter (~12 years), and Saturn (~29 years). Saturn return is a major life milestone in Western astrology.","enum":["Mercury","Venus","Mars","Jupiter","Saturn"],"example":"Jupiter"},{"key":"approximateDate","name":"approximateDate","kind":"date","required":true,"description":"Approximate date near the expected planetary return (YYYY-MM-DD). The return nearest this date is returned, so a date off by months still lands on a genuine return; during a retrograde loop the planet crosses its natal degree up to three times and the crossing nearest the date is the one returned.","example":"2026-08-15"},{"key":"latitude","name":"latitude","kind":"number","required":true,"description":"Latitude of the return location in decimal degrees (-90 to 90). Affects house cusps and Ascendant of the return chart.","min":-90,"max":90,"example":40.7128,"role":"location"},{"key":"longitude","name":"longitude","kind":"number","required":true,"description":"Longitude of the return location in decimal degrees (-180 to 180).","min":-180,"max":180,"example":-74.006,"role":"location"},{"key":"timezone","name":"timezone","kind":"number","required":true,"description":"Decimal hours from UTC OR IANA name (e.g. \"America/New_York\"). IANA resolved to the DST-correct offset for the birthDate. Output datetime is adjusted to this timezone.","min":-14,"max":14,"example":"America/New_York","role":"location"},{"key":"houseSystem","name":"houseSystem","kind":"tiles","required":false,"description":"House system for the return chart. Placidus (default), Whole Sign, Equal, or Koch.","enum":["placidus","whole-sign","equal","koch"],"default":"placidus","example":"placidus","fold":true}],"hasLang":true,"groups":[{"location":{"fields":["latitude","longitude","timezone"],"required":true}}],"opensOnLoad":false}