API de astrologia Local Space

O endpoint constrói o mapa natal, converte cada planeta das coordenadas eclípticas para o referencial do horizonte do local de nascimento, e devolve o seu azimuth em graus no sentido horário a partir do norte verdadeiro juntamente com a sua altitude acima ou abaixo do horizonte. Depois projeta cada azimuth como um great circle a partir do local de nascimento e devolve o caminho resultante como uma série de coordenadas, para que uma linha desenhada num mapa mundial mantenha a verdadeira orientação em vez de ser uma linha reta numa projeção plana. Treze corpos são incluídos, cada um com uma cor estável para que o mapa renderizado mantenha a mesma paleta que o resto da suite. Aqui a altitude conta tanto quanto o azimuth: um planeta abaixo do horizonte no nascimento lê-se diferente de um alto no céu na mesma direção.

curl -X POST https://api.astroway.info/v1/local-space \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52
}'

{
  "ok": true,
  "data": {
    "birthplace": { "latitude": 50.45, "longitude": 30.52 },
    "count": 13,
    "lines": [
      {
        "planetId": 0,
        "planetName": "Sun",
        "azimuth": 219.8018,
        "altitude": 53.1309,
        "color": "#FFB300",
        "points": [{ "lat": 50.45, "lng": 30.52 }, "…"]
      }
    ]
  }
}

Usa o Local Space quando o teu produto trata de direção e distância a partir de um ponto fixo, em vez de posição absoluta no globo. Dois casos predominam. O primeiro é a mudança de local em qualquer escala, desde escolher que cidade fica ao longo de um rumo favorável até decidir para onde te mudas dentro de um país, porque um great circle a partir do local de nascimento atravessa muito mais território utilizável do que alguns meridianos de astrocartografia. O segundo é trabalho interior e de sítio, onde os mesmos azimuths são lidos a escala de um quarto dentro de uma habitação: o endpoint devolve os bearings, e o companion /local-space/influence-zone transforma um deles num polígono em cone que podes desenhar. Se já renderizas astrocartografia, adicionar o Local Space é a forma mais barata de duplicar a profundidade de uma funcionalidade de mudança, já que usa a mesma entrada de nascimento e a mesma superfície de mapa.

As posições vêm da Swiss Ephemeris (Astrodienst). O azimuth é medido no sentido horário a partir do norte verdadeiro, não do norte magnético, por isso não se aplica nem se precisa de correção de declinação. O caminho great-circle é devolvido como coordenadas amostradas em vez de uma fórmula, o que mantém o cliente livre da geometria esférica. A técnica nesta forma foi desenvolvida por Michael Erlewine e está documentada nas suas Astrophysical Directions.