API de carta equivalente geodésica

Dada uma latitude e uma longitude, o endpoint devolve o Meio-do-Céu geodésico, o Imum Coeli, o Ascendente e o Descendente em graus eclípticos, juntamente com o índice do signo e o grau dentro do signo para o MC e o Ascendente. Duas escolas são suportadas. Sepharial, a predefinida, mapeia a longitude terrestre diretamente para a longitude zodiacal, pelo que 30,52 graus este correspondem a 0 graus e 31 minutos de Touro. Johndro aplica uma correção de obliquidade, que desloca o Ascendente relativamente ao valor de Sepharial e requer um ano ou uma obliquidade explícita em graus. Como nada sobre uma pessoa entra no cálculo, as mesmas coordenadas devolvem sempre os mesmos ângulos, o que torna o endpoint barato de cachear e a âncora natural para uma funcionalidade baseada no lugar e não na pessoa.

curl -X POST https://api.astroway.info/v1/geodetic \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "latitude": 50.45,
  "longitude": 30.52,
  "method": "sepharial"
}'

{
  "ok": true,
  "data": {
    "mc": 30.52,
    "ic": 210.52,
    "asc": 317.7269,
    "dsc": 137.7269,
    "mcSign": 1,
    "mcDegree": 0.52,
    "ascSign": 10,
    "ascDegree": 17.7269,
    "method": "sepharial"
  }
}

Recorre à carta geodésica em trabalho mundano, em que o sujeito é um país, uma cidade ou um evento, e não uma pessoa. Usos típicos são testar se um eclipse ou um ingresso cai sobre os ângulos geodésicos de uma capital, construir uma página de perfil de país que precisa de uma carta mas não tem uma hora de fundação defensável, e cruzar a astrocartografia com um método completamente independente. Também resolve um problema prático em produtos de consumo: quando um utilizador não tem hora de nascimento, a maioria dos endpoints de cartas degrada-se bastante, mas uma carta geodésica da sua cidade atual continua totalmente definida e continua a dizer algo específico sobre o lugar. A resposta é pequena e determinística, por isso custa uma única chamada de nível um e é segura de calcular para uma lista inteira de cidades de uma só vez.

Sepharial e Johndro divergem por conceção, não por erro; ambos são devolvidos a pedido em vez de um ser apresentado como canónico. A técnica tem origem em Sepharial no início do século XX e foi alargada por L. Edward Johndro. Como a moldura geodésica está fixa ao meridiano de Greenwich, os resultados são estáveis ao longo do tempo e não requerem qualquer consulta de efemérides, razão pela qual este é o único endpoint da família de astro-geografia que não depende do Swiss Ephemeris.