Trânsitos

Calcula trânsitos planetários e os seus aspectos a um mapa natal durante um período de tempo especificado.

Calcular Trânsitos

Calcula trânsitos para um intervalo de datas:

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-01-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
birthDate	string	Sim	Data/hora de nascimento no formato YYYY-MM-DDTHH:mm
birthLocation	object	Sim	Local de nascimento com latitude, longitude e fuso horário
transitDateStart	string	Sim	Início do período de trânsito no formato YYYY-MM-DDTHH:mm
transitDateEnd	string	Sim	Fim do período de trânsito no formato YYYY-MM-DDTHH:mm
transitLocation	object	Sim	Local do trânsito com latitude, longitude e fuso horário
houseSystem	string	Não	Sistema de casas (padrão: "placidus")
points	array	Não	Pontos celestes a calcular
orbs	object	Não	Valores de orbe personalizados por tipo de aspecto
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)

Objecto de Localização

{
  "latitude": 51.5074,
  "longitude": -0.1278,
  "timezone": "Europe/London"
}

Resposta

A resposta inclui cruzamentos de trânsitos (quando os planetas entram/saem de signos ou casas), posições das casas em trânsito, aspectos entre planetas em trânsito e natais, e URLs dos mapas.

{
  "data": {
    "crossings": [...],
    "transitHouses": [...],
    "aspects": [
      {
        "point1": "saturn",
        "point2": "sun",
        "aspect": "conjunction",
        "orb": 1.2,
        "applying": true
      }
    ],
    "charts": {
      "transit": {
        "title": "Transit Chart (Bi-wheel)",
        "url": "..."
      },
      "natal": {
        "title": "Natal Chart",
        "url": "..."
      }
    },
    "natalPoints": [...],
    "natalHouses": [...],
    "transitPoints": [...]
  }
}

Orbes Personalizados

Especifica valores de orbe personalizados para diferentes tipos de aspectos:

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-01-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "orbs": {
      "conjunction": 3,
      "opposition": 3,
      "trine": 2,
      "square": 2
    }
  }'

Com Texto de Interpretação

Inclui texto de interpretação nos teus cálculos de trânsitos:

curl -X POST "https://api.astroapi.cloud/api/calc/transit" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-15T00:00",
    "transitDateEnd": "2024-01-15T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "includeText": true,
    "language": "en"
  }'

Exportação iCal

Exporta eventos de trânsitos como um ficheiro iCal (.ics) que pode ser importado em aplicações de calendário como o Google Calendar, Apple Calendar ou Outlook.

POST /api/calc/transit/ical

curl -X POST "https://api.astroapi.cloud/api/calc/transit/ical" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15T14:30",
    "birthLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "transitDateStart": "2024-01-01T00:00",
    "transitDateEnd": "2024-03-31T23:59",
    "transitLocation": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }' --output transits.ics

A resposta é um ficheiro text/calendar com Content-Disposition: attachment; filename="transits.ics".

Parâmetros

A exportação iCal aceita os mesmos parâmetros que o endpoint de trânsitos padrão, mais:

Parâmetro	Tipo	Obrigatório	Descrição
aspects	array	Não	Filtrar por tipos de aspecto (ex.: ["conjunction", "trine"])

TIP

Importa o ficheiro .ics descarregado na tua aplicação de calendário para ver os eventos de trânsitos como entradas de calendário com descrições de cada aspecto.