Períodos de combustão

Quando um planeta está perto demais do Sol para ser visto, diz-se que ele está combusto — asta, 'ocaso' —, e os textos clássicos o tratam como queimado e incapaz de produzir seus resultados. Este endpoint retorna, para um planeta, todos os períodos de combustão que caem, ao menos em parte, em um ano civil. O teste é puramente angular. O planeta fica combusto enquanto sua elongação geocêntrica em relação ao Sol estiver abaixo de um orbe próprio de cada planeta: 17° para Marte, 14° para Mercúrio direto e 12° retrógrado, 10° para Vênus direto e 8° retrógrado, 11° para Júpiter e 15° para Saturno. O ano é varrido com uma margem em cada ponta, porque um período pode atravessar a virada do ano, e cada cruzamento é depois refinado por bisseção. Envie `planet` (mars, mercury, venus, jupiter ou saturn) e `year`. A resposta é `{planet, year, periods, total_asta_days_in_year}`, em que cada período traz `start`, `end`, `duration_days` para o período inteiro e `days_in_year` para a parte que cai dentro do ano solicitado. A elongação não depende de onde você está, então os horários não dependem da localização; `timezone_as_float` só define como eles são exibidos.

Referência completa deste endpoint