curl -X POST https://api.occultapi.com/api/astro/telugu_calendar/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'O calendário telugu é lunissolar Amanta: os meses vão de uma lua nova à seguinte, têm nomes em telugu (Chaithramu, Vaisakhamu, Jyesthamu, Ashadhamu, Sravanamu, Bhadhrapadamu, Asvayujamu, Karthikamu, Margasiramu, Pushyamu, Maghamu e Phalgunamu), e o ano é contado em Shaka Samvat e começa em Ugadi, no Chaithramu Shukla Padyami. A aritmética de meses subjacente, incluindo a detecção do mês adhika, é a mesma que os calendários marathi e kannada usam — a diferença entre esses três está nos nomes dos meses e na lista de festivais, não na astronomia. Não é o esquema solar de signo a signo dos calendários tâmil e malaiala. Envie um `year` com `latitude`, `longitude` e `timezone_as_float`. A resposta é `{year, events}` e cada evento é apenas `{name, date}`; ao contrário do calendário tâmil, não há campos de mês nem de dia do mês. Espere cerca de noventa entradas por ano: os vinte e quatro Ekadashis (vinte e seis em um ano adhika) com seus nomes em telugu, junto com as alternativas Gauna e Vaishnava do dia seguinte que a maioria dos outros calendários regionais omite, aproximadamente vinte e cinco Pradosh Vrats nomeados pelo dia da semana (Ravi, Soma, Bhauma, Budha, Guru, Shukra, Shani), os doze Sankashtahara Chaturthis, os doze vratas de Shukla Dwadashi e os principais festivais. O nascer do sol, o pôr do sol e a janela de Pradosha são calculados para as coordenadas que você envia, então uma cidade diferente pode mover uma data em um dia; a regra do Pradosh Vrat, em particular, atribui cada Trayodashi ao dia civil cuja janela de Pradosha, após o pôr do sol, tem a maior sobreposição com ele. Os festivais compartilhados com o calendário hindu principal são lidos da tabela pré-calculada, que cobre apenas 2006-2046.
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| latitude | number (double) | obrigatório | Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes. |
| longitude | number (double) | obrigatório | Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China. |
| timezone_as_float | number (double) | obrigatório | Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30), -5 para Nova York no inverno, 5.75 para o Nepal. Este valor NÃO é conferido com date_time: se os dois divergirem, você recebe uma resposta bem-sucedida para o momento errado. Por isso, tire os dois da mesma fonte. Use o deslocamento em vigor naquela data, não o de hoje: quem nasceu no verão, em um país com horário de verão, precisa do deslocamento de verão. |
| year | integer | obrigatório | Ano de nascimento como número, por exemplo 1990. Quatro dígitos. min 2006 · max 2046 |