Revoluções Solar e Lunar
Calcula mapas de revolução solar (mapa de aniversário) e de revolução lunar. Os mapas de revolução mostram as posições planetárias no momento exacto em que um planeta regressa à sua posição natal, fornecendo visão preditiva para o ano ou mês seguinte.
Revolução Solar
Um mapa de revolução solar é calculado para o momento exacto em que o Sol regressa ao seu grau natal a cada ano, o que ocorre perto do aniversário. É usado para prever os temas do ano seguinte.
Módulo Necessário
Requer o módulo solar-return:calc.
bash
curl -X POST "https://api.astroapi.cloud/api/calc/solar-return" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"birthDateTime": "1990-06-15T14:30",
"birthLocation": {
"longitude": -0.1278,
"latitude": 51.5074,
"timezone": "Europe/London"
},
"returnYear": 2024,
"houseSystem": "placidus",
"language": "en",
"includeText": true,
"includeReadableEntities": true
}'Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
birthDateTime | string | Sim | Data e hora de nascimento no formato YYYY-MM-DDTHH:mm |
birthLocation | object | Sim | Local de nascimento (ver Objecto de Localização abaixo) |
returnYear | number | Não | Ano para a revolução solar (padrão: ano actual) |
houseSystem | string | Não | Sistema de casas (padrão: "placidus") |
language | string | Não | Código de idioma para o conteúdo de texto (padrão: "en") |
includeText | boolean | Não | Incluir texto de interpretação (padrão: false) |
includeReadableEntities | boolean | Não | Incluir títulos de entidades legíveis por humanos (padrão: false) |
points | array | Não | Pontos celestes a incluir no cálculo |
orbs | object | Não | Valores de orbe personalizados por tipo de aspecto |
Objecto de Localização
json
{
"longitude": -0.1278,
"latitude": 51.5074,
"timezone": "Europe/London"
}Resposta
json
{
"data": {
"returnYear": 2024,
"returnDate": "2024-06-15T08:42:17Z",
"aspects": [
{
"point1": "sun",
"point2": "moon",
"aspect": "trine",
"orb": 1.8,
"applying": false
}
],
"points": {
"sun": {
"longitude": 84.71,
"latitude": 0.0,
"sign": "gemini",
"house": 10,
"retrograde": false
},
"moon": {
"longitude": 324.15,
"latitude": -2.3,
"sign": "aquarius",
"house": 6,
"retrograde": false
}
},
"houses": {
"1": { "cusp": 195.4, "sign": "libra" },
"10": { "cusp": 84.5, "sign": "gemini" }
},
"charts": {
"solarReturn": {
"title": "Solar Return Chart",
"url": "https://api.astroapi.cloud/api/chart/..."
},
"biWheel": {
"title": "Solar Return / Natal Bi-wheel",
"url": "https://api.astroapi.cloud/api/chart/..."
},
"natal": {
"title": "Natal Chart",
"url": "https://api.astroapi.cloud/api/chart/..."
}
}
}
}Campos da Resposta
| Campo | Tipo | Descrição |
|---|---|---|
returnYear | number | O ano desta revolução solar |
returnDate | string | Momento UTC exacto da revolução solar |
aspects | array | Aspectos dentro do mapa de revolução solar |
points | object | Posições planetárias no mapa de revolução solar |
houses | object | Cúspides das casas para o mapa de revolução solar |
charts.solarReturn | object | URL da imagem do mapa de revolução solar |
charts.biWheel | object | Mapa bi-roda mostrando a revolução solar sobreposta ao mapa natal |
charts.natal | object | URL da imagem do mapa natal |
Revolução Lunar
Um mapa de revolução lunar é calculado para o momento exacto em que a Lua regressa ao seu grau natal a cada mês (aproximadamente a cada 27,3 dias). É usado para prever os temas do mês seguinte.
Módulo Necessário
Requer o módulo lunar-return:calc.
bash
curl -X POST "https://api.astroapi.cloud/api/calc/lunar-return" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"birthDateTime": "1990-06-15T14:30",
"birthLocation": {
"longitude": -0.1278,
"latitude": 51.5074,
"timezone": "Europe/London"
},
"returnDate": "2024-06-01",
"houseSystem": "placidus",
"language": "en",
"includeText": true,
"includeReadableEntities": true
}'Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
birthDateTime | string | Sim | Data e hora de nascimento no formato YYYY-MM-DDTHH:mm |
birthLocation | object | Sim | Local de nascimento (longitude, latitude, fuso horário) |
returnDate | string | Não | Data de início (YYYY-MM-DD) a partir da qual encontrar a próxima revolução lunar (padrão: agora) |
houseSystem | string | Não | Sistema de casas (padrão: "placidus") |
language | string | Não | Código de idioma para o conteúdo de texto (padrão: "en") |
includeText | boolean | Não | Incluir texto de interpretação (padrão: false) |
includeReadableEntities | boolean | Não | Incluir títulos de entidades legíveis por humanos (padrão: false) |
points | array | Não | Pontos celestes a incluir no cálculo |
orbs | object | Não | Valores de orbe personalizados por tipo de aspecto |
Resposta
json
{
"data": {
"returnDate": "2024-06-12T03:18:44Z",
"aspects": [
{
"point1": "moon",
"point2": "venus",
"aspect": "sextile",
"orb": 0.9,
"applying": true
}
],
"points": {
"moon": {
"longitude": 245.2,
"latitude": -3.1,
"sign": "sagittarius",
"house": 4,
"retrograde": false
}
},
"houses": {
"1": { "cusp": 130.8, "sign": "leo" },
"4": { "cusp": 240.5, "sign": "sagittarius" }
},
"charts": {
"lunarReturn": {
"title": "Lunar Return Chart",
"url": "https://api.astroapi.cloud/api/chart/..."
},
"biWheel": {
"title": "Lunar Return / Natal Bi-wheel",
"url": "https://api.astroapi.cloud/api/chart/..."
},
"natal": {
"title": "Natal Chart",
"url": "https://api.astroapi.cloud/api/chart/..."
}
}
}
}Campos da Resposta
| Campo | Tipo | Descrição |
|---|---|---|
returnDate | string | Momento UTC exacto da revolução lunar |
aspects | array | Aspectos dentro do mapa de revolução lunar |
points | object | Posições planetárias no mapa de revolução lunar |
houses | object | Cúspides das casas para o mapa de revolução lunar |
charts.lunarReturn | object | URL da imagem do mapa de revolução lunar |
charts.biWheel | object | Mapa bi-roda mostrando a revolução lunar sobreposta ao mapa natal |
charts.natal | object | URL da imagem do mapa natal |
Sistemas de Casas
Ambos os endpoints suportam os mesmos sistemas de casas que os cálculos de mapa natal:
| Valor | Nome |
|---|---|
placidus | Placidus (padrão) |
koch | Koch |
equal | Casas Iguais |
whole | Signo Inteiro |
campanus | Campanus |
regiomontanus | Regiomontanus |
porphyry | Porphyry |
Localização para Mapas de Revolução
Muitos astrólogos utilizam a localização onde a pessoa se encontra fisicamente no momento da revolução, em vez do local de nascimento. Passa a residência actual ou localização de viagem em birthLocation se quiseres mapas de revolução relativos à localização.