Orbes de Aspectos

Os orbes determinam o intervalo dentro do qual dois corpos celestes são considerados como formando um aspecto. A AstroAPI utiliza orbes padrão cuidadosamente ajustados para cada tipo de mapa, mas podes substituí-los quando necessário.

O que São os Orbes?

Um orbe é o desvio permitido em relação ao ângulo exacto do aspecto. Por exemplo, uma conjunção ocorre quando dois planetas estão a 0° de distância. Com um orbe de 8°, planetas entre 0° e 8° de distância seriam considerados em conjunção.

Orbes Padrão por Tipo de Mapa

A AstroAPI utiliza orbes padrão diferentes para tipos de mapas distintos, reflectindo as melhores práticas astrológicas:

Mapas Natais

Aspecto	Ângulo	Orbe Padrão
Conjunção	0°	8°
Oposição	180°	8°
Trígono	120°	8°
Quadratura	90°	8°
Sextil	60°	6°
Quincúncio	150°	4°
Semissextil	30°	3°
Quintil	72°	2°
Biquintil	144°	2°
Octil	45°	2°
Trioctil	135°	2°

Mapas de Trânsito

Os aspectos de trânsito utilizam orbes mais apertados porque indicam timing:

Aspecto	Ângulo	Orbe Padrão
Conjunção	0°	2,6°
Oposição	180°	2,5°
Trígono	120°	2,3°
Quadratura	90°	2,3°
Sextil	60°	2,3°
Quincúncio	150°	2°

Mapas de Sinastria

A sinastria utiliza orbes variáveis com base nos planetas envolvidos:

• Conjunções e oposições Sol/Lua: Máx. 5°
• Outros aspectos Sol/Lua (trígono, quadratura, sextil): Máx. 3°
• Todas as outras combinações de planetas: Máx. 3°

Mapas Compostos

Os mapas compostos utilizam um orbe consistente de 2,5° para todos os aspectos maiores.

Mapas de Revolução Solar e Lunar

Os mapas de revolução utilizam um orbe de 6° para todos os aspectos maiores.

Progressões Secundárias

As progressões utilizam orbes muito apertados de 1° para todos os aspectos, devido ao movimento lento dos planetas progredidos.

Orbes Personalizados

Podes substituir os orbes padrão incluindo um objecto orbs no teu pedido. Especifica apenas os aspectos que queres personalizar — os aspectos não especificados usarão os seus valores padrão.

Exemplo: Orbes Personalizados para Mapa Natal

{
  "dateTime": "1990-06-15T14:30",
  "location": {
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  },
  "orbs": {
    "conjunction": 10,
    "opposition": 10,
    "trine": 6,
    "square": 6
  }
}

Exemplo: Orbes Apertados para Precisão

{
  "dateTime": "1990-06-15T14:30",
  "location": {
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  },
  "orbs": {
    "conjunction": 3,
    "opposition": 3,
    "trine": 2,
    "square": 2,
    "sextile": 2
  }
}

Tipos de Aspectos Disponíveis

ID do Aspecto	Nome	Ângulo
conjunction	Conjunção	0°
opposition	Oposição	180°
trine	Trígono	120°
square	Quadratura	90°
sextile	Sextil	60°
quincunx	Quincúncio/Inconjunto	150°
semisextile	Semissextil	30°
quintile	Quintil	72°
biquintile	Biquintil	144°
octile	Octil/Semiquadratura	45°
trioctile	Trioctil/Sesquiquadratura	135°
decile	Décil	36°
tridecile	Tridécil	108°

Boas Práticas

1. Usa os valores padrão na maioria dos casos — Os orbes padrão são cuidadosamente escolhidos com base na tradição astrológica e funcionam bem para a maioria das aplicações.

2. Orbes mais apertados para previsão — Ao procurar timing preciso (trânsitos, progressões), usa orbes mais apertados.

3. Orbes mais amplos para análise de relacionamentos — A sinastria e os mapas natais podem beneficiar de orbes ligeiramente mais amplos para captar todas as conexões significativas.

4. Os luminares merecem orbes mais amplos — O Sol e a Lua recebem tradicionalmente orbes mais amplos do que os outros planetas devido à sua importância astrológica.

5. Os aspectos menores precisam de orbes apertados — Aspectos como o quintil, semissextil e octil devem usar orbes de 2° ou menos para garantir significância.

Endpoints Suportados

Os orbes personalizados são suportados nos seguintes endpoints:

• /calc/natal — Cálculo de mapa natal
• /calc/synastry — Cálculo de mapa de sinastria
• /calc/composite — Cálculo de mapa composto
• /calc/solar-return — Cálculo de revolução solar
• /calc/lunar-return — Cálculo de revolução lunar