AstroWay/api v2.296.1 · es
todos los sistemas funcionando con normalidad
// astrology api · POST /v1/geodetic

API de carta equivalente geodésica

Una carta geodésica obtiene los cuatro ángulos solo a partir de la geografía. Cero grados de Aries está fijado al meridiano de Greenwich, cada grado de longitud se convierte en un grado del zodíaco, y cualquier lugar en la Tierra adquiere un Midheaven y un Ascendant sin que se necesite la hora de nacimiento.

Endpoint
POST /v1/geodetic
Coste
10 créditos
Latencia
~121 ms
Nivel
Tier 1
// 01 / Qué calcula

API de carta equivalente geodésica

Dada una latitud y longitud, el endpoint devuelve el Midheaven geodésico, Imum Coeli, Ascendant y Descendant en grados eclípticos, junto con el índice del signo y el grado dentro del signo para el MC y el Ascendant. Se admiten dos escuelas. Sepharial, la predeterminada, asigna la longitud terrestre directamente a la longitud zodiacal, así 30.52 grados al este son 0 grados 31 minutos de Tauro. Johndro aplica una corrección de obliquity, que desplaza el Ascendant respecto al valor de Sepharial y requiere un año o una obliquity explícita en grados. Como nada de la persona entra en el cálculo, las mismas coordenadas siempre devuelven los mismos ángulos, lo que hace que el endpoint sea barato de cachear y el ancla natural para una función basada en lugares en lugar de personas.

// 02 / Solicitud en vivo

POST/v1/geodetic

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"
}'
Respuesta (fragmento)
{
  "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"
  }
}
// 03 / Parámetros

Parámetros

nametypeObligatorio
latitude number sí Place latitude, decimal degrees (north positive).
longitude number sí Place longitude, decimal degrees (east positive). This is what drives the geodetic MC.
method string no sepharial (default) maps longitude directly onto the zodiac; johndro applies an obliquity correction.
year number no Year used for the obliquity value in the johndro method. Ignored by sepharial.
obliquity number no Explicit obliquity in degrees, overriding the year-derived value.
// 04 / Cuándo usarlo

Cuándo usarlo

Usa la carta geodésica en trabajos cotidianos, donde el sujeto es un país, una ciudad o un evento en lugar de una persona. Los usos típicos son probar si un eclipse o una entrada cae en los ángulos geodésicos de una capital, crear una página de perfil de país que necesita una carta pero no tiene una hora de fundación defendible, y comparar la astrocartografía con un método completamente independiente. También resuelve un problema práctico en productos de consumo: cuando un usuario no tiene hora de nacimiento, la mayoría de los endpoints de cartas se degradan, pero una carta geodésica para su ciudad actual sigue estando totalmente definida y sigue diciendo algo concreto sobre el lugar. La respuesta es pequeña y determinista, por lo que cuesta una única llamada de nivel uno y es segura de calcular para una lista completa de ciudades de una sola vez.

// 05 / Notas

Notas

Sepharial y Johndro discrepan por diseño, no por error; ambos se devuelven bajo petición en lugar de presentar uno como canónico. La técnica se originó con Sepharial a principios del siglo XX y la amplió L. Edward Johndro. Como el marco geodésico está fijado al meridiano de Greenwich, los resultados son estables en el tiempo y no requieren búsqueda de ephemeris, por eso este es el único endpoint de la familia astro-geografía que no depende de Swiss Ephemeris.

Prueba la API de Carta Geodésica

Consigue una clave y haz tu primera llamada en menos de un minuto.

99.9% SLA · planes de pago · 30 días estado →