astroAPI — POST /v1/local-space

Beschreibung

Liefert pro Koerper die Richtung am oertlichen Horizont: Kompass-Azimut (Nord = 0°, ueber Ost = 90°), 16-teilige Kompassrose, wahre und scheinbare Hoehe (mit Refraktion) sowie Sichtbarkeit. Rechengrundlage der Local-Space-Astrologie und der Kompass-Analyse (Wohn-/Reiserichtungen); die Grosskreis-Linien auf der Weltkarte folgen mit der Kartografie-Welle. Konvention: geozentrische Positionen (wie in der Local-Space-Tradition ueblich).

Parameter

Name	In	Typ	Pflicht	Beschreibung
`datetime`	body	string	ja	ISO 8601 UTC.
`location`	body	object	ja	{latitude, longitude, altitude?} — Beobachtungs- bzw. Geburts-/Wohnort.
`bodies`	body	array	nein	Koerper-Namen. Default: Sonne..Pluto + Chiron + true_node.
`pressure_hpa / temperature_c`	body	number	nein	Atmosphaere fuer die Refraktion der scheinbaren Hoehe. Default 1013.25 hPa / 15 °C.
`include_lines`	body	boolean	nein	true = pro Koerper zusaetzlich die Local-Space-LINIE: Grosskreis vom Ort entlang des Azimuts als Weltkarten-Segmente [[lat,lon],…].
`line_step_degrees`	body	number	nein	Aufloesung der Linie (0.5..10). Default 2.

Beispiel-Aufruf

Variante: Direkter HTTP-Aufruf, keine Abhaengigkeit.

curl -sS \
  -H "X-API-Key: ak_test_<DEIN_KEY>" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "datetime": "1987-06-21T04:30:00Z",
    "location": {
        "latitude": 48.137,
        "longitude": 11.575
    },
    "bodies": [
        "sun",
        "moon"
    ]
}' \
  "https://astroapi.services/v1/local-space"

<?php
$ch = curl_init("https://astroapi.services/v1/local-space");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: ak_test_<DEIN_KEY>", "Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"datetime":"1987-06-21T04:30:00Z","location":{"latitude":48.137,"longitude":11.575},"bodies":["sun","moon"]}');
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

<?php
require 'astroapi-client.php';
$api = new AstroApiClient('ak_test_<DEIN_KEY>');
$response = $api->localSpace([
    'datetime' => '1987-06-21T04:30:00Z',
    'location' => [
        'latitude' => 48.137,
        'longitude' => 11.575,
    ],
    'bodies' => [
        'sun',
        'moon',
    ],
]);
print_r($response);

const response = await fetch('https://astroapi.services/v1/local-space', {
  method: 'POST',
  headers: { 'X-API-Key': 'ak_test_<DEIN_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "datetime": "1987-06-21T04:30:00Z",
    "location": {
        "latitude": 48.137,
        "longitude": 11.575
    },
    "bodies": [
        "sun",
        "moon"
    ]
}),
});
const data = await response.json();
console.log(data);

import { AstroApiClient } from './astroapi-client.js';

const api = new AstroApiClient('ak_test_<DEIN_KEY>');
const response = await api.localSpace({
    "datetime": "1987-06-21T04:30:00Z",
    "location": {
        "latitude": 48.137,
        "longitude": 11.575
    },
    "bodies": [
        "sun",
        "moon"
    ]
});
console.log(response);

import requests

url = 'https://astroapi.services/v1/local-space'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
payload = {
    "datetime": "1987-06-21T04:30:00Z",
    "location": {
        "latitude": 48.137,
        "longitude": 11.575
    },
    "bodies": [
        "sun",
        "moon"
    ]
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

from astroapi_client import AstroApiClient

api = AstroApiClient('ak_test_<DEIN_KEY>')
response = api.local_space({
    'datetime': '1987-06-21T04:30:00Z',
    'location': {
        'latitude': 48.137,
        'longitude': 11.575,
    },
    'bodies': [
        'sun',
        'moon',
    ],
})
print(response)