Mapas Natais

Calcula mapas natais completos com posições planetárias, cúspides das casas e aspetos.

Cálculo Básico

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
dateTime	string	Sim	Data/hora no formato YYYY-MM-DDTHH:mm
location.latitude	number	Sim	Latitude (-90 a 90)
location.longitude	number	Sim	Longitude (-180 a 180)
location.timezone	string	Sim	Identificador de fuso horário IANA
houseSystem	string	Não	Sistema de casas (padrão: "placidus")
points	array	Não	Pontos celestes a calcular (ver Pontos Disponíveis abaixo)
orbs	object	Não	Valores de orbe personalizados por tipo de aspeto (ex.: { "conjunction": 8, "opposition": 6 })
language	string	Não	Código de idioma para conteúdo textual (padrão: "en")
includeText	boolean	Não	Incluir texto de interpretação (padrão: false)
includeReadableEntities	boolean	Não	Incluir títulos legíveis das entidades (padrão: false)

Sistemas de Casas

• placidus — Placidus (padrão)
• koch — Koch
• equal — Casas Iguais
• whole — Signo Inteiro
• campanus — Campanus
• regiomontanus — Regiomontanus
• porphyry — Porphyry

Resposta

{
  "data": {
    "dateTime": "1990-06-15T12:30:00.000Z",
    "points": {
      "sun": {
        "pointId": "sun",
        "longitude": 84.5,
        "sign": "gemini",
        "signTitle": "Gemini",
        "degreesInSign": 24.5,
        "degreesInSignDms": [24, 30, 0],
        "houseNumber": 10,
        "houseId": "house-10",
        "retrograde": false,
        "pointTitle": "Sun",
        "houseTitle": "10th House"
      },
      "moon": {
        "pointId": "moon",
        "longitude": 245.2,
        "sign": "sagittarius",
        "signTitle": "Sagittarius",
        "degreesInSign": 5.2,
        "degreesInSignDms": [5, 12, 0],
        "houseNumber": 4,
        "houseId": "house-4",
        "retrograde": false,
        "pointTitle": "Moon",
        "houseTitle": "4th House"
      }
    },
    "houses": {
      "cusps": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 210.3, "longitudeDms": { "degrees": 210, "minutes": 18, "seconds": 0 }, "sign": "scorpio" }
      ],
      "ascmc": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 270.2, "longitudeDms": { "degrees": 270, "minutes": 12, "seconds": 0 }, "sign": "capricorn" }
      ]
    },
    "aspects": [
      {
        "pointA": "sun",
        "pointB": "moon",
        "aspect": "opposition",
        "angle": 160.7,
        "orb": 0.7,
        "applying": false,
        "pointATitle": "Sun",
        "pointBTitle": "Moon",
        "aspectTitle": "Opposition"
      }
    ],
    "chart": {
      "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..."
    }
  }
}

Cúspides das Casas

Cada objeto de cúspide inclui longitude (graus eclípticos), longitudeDms (graus/minutos/segundos) e sign (identificador do signo zodiacal). A primeira cúspide (cusps[0]) é o Ascendente. O array ascmc contém o Ascendente, MC, ARMC e Vértex.

Pontos Disponíveis

Utilize o parâmetro points para selecionar quais pontos celestes calcular. Se omitido, o conjunto padrão é utilizado.

Pontos Padrão

sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, meanNode, trueNode, meanApogee, osculatingApog

Todos os Pontos Disponíveis

Point ID	Descrição
sun	Sol
moon	Lua
mercury	Mercúrio
venus	Vénus
mars	Marte
jupiter	Júpiter
saturn	Saturno
uranus	Urano
neptune	Neptuno
pluto	Plutão
meanNode	Nodo Norte Médio
trueNode	Nodo Norte Verdadeiro
meanApogee	Lilith Média (Lua Negra)
osculatingApog	Lilith Verdadeira (Lua Negra)
chiron	Quíron
pholus	Folo
ceres	Ceres
pallas	Palas
juno	Juno
vesta	Vesta
interpolatedLunarApogee	Apogeu Lunar Interpolado
interpolatedLunarPerigee	Perigeu Lunar Interpolado (Priapo)
earth	Terra

Exemplo: Calcular Apenas Sol e Marte

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "points": ["sun", "mars"]
  }'

A resposta terá sun e mars no objeto points, e os quatro ângulos no objeto angles:

{
  "data": {
    "points": {
      "sun": { "pointId": "sun", "longitude": 84.5, "sign": "gemini", ... },
      "mars": { "pointId": "mars", "longitude": 12.3, "sign": "aries", ... }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries", ... },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn", ... },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer", ... }
    },
    "houses": { ... },
    "aspects": [ ... ]
  }
}

Ângulos

Os quatro ângulos (ascendant, descendant, midheaven, imumCoeli) são sempre incluídos no objeto angles, independentemente do parâmetro points. Os ângulos são derivados dos cálculos das casas, não da efeméride, pelo que possuem uma estrutura mais simples (sem dados de velocidade ou retrogradação). O array ascmc na resposta houses também contém sempre as longitudes brutas dos ângulos.

Lua e Sol

Calcula a fase lunar, iluminação, horários de nascente/poente e dados da posição solar.

POST /api/calc/moon-sun

curl -X POST "https://api.astroapi.cloud/api/calc/moon-sun" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    }
  }'

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
dateTime	string	Sim	Data/hora no formato YYYY-MM-DDTHH:mm
location.latitude	number	Sim	Latitude (-90 a 90)
location.longitude	number	Sim	Longitude (-180 a 180)
location.timezone	string	Sim	Identificador de fuso horário IANA

Módulo Necessário

Este endpoint requer o módulo module:moon.

Resposta

{
  "data": {
    "moon": {
      "phaseName": "Waxing Gibbous",
      "phase": 0.62,
      "illumination": 0.78,
      "age": 9.2,
      "distance": 384400,
      "diameterDegrees": 0.52,
      "rise": "2024-06-15T14:23:00Z",
      "set": "2024-06-16T02:15:00Z"
    },
    "sun": {
      "rise": "2024-06-15T05:18:00Z",
      "set": "2024-06-15T22:03:00Z",
      "transit": "2024-06-15T13:40:00Z",
      "distance": 151820000,
      "diameterDegrees": 0.524,
      "twilight": {
        "civil": {
          "begin": "2024-06-15T04:38:00Z",
          "end": "2024-06-15T22:43:00Z"
        },
        "nautical": {
          "begin": "2024-06-15T03:32:00Z",
          "end": "2024-06-15T23:49:00Z"
        },
        "astronomical": {
          "begin": null,
          "end": null
        }
      }
    }
  }
}

Precisão dos Cálculos

A AstroAPI lê diretamente a efeméride JPL DE442 da NASA para posições planetárias com precisão sub-milissegundo de arco. Consulte a página Precisão dos Cálculos para todos os detalhes sobre as nossas fontes de dados e correções.