/v1/planets
API-Key noetig Berechnung Ekliptikale Positionen und Geschwindigkeiten aller Standardpunkte fuer einen Zeitpunkt.
Beschreibung
Liefert Laenge, Breite, Distanz und die drei Geschwindigkeitskomponenten fuer Sonne, Mond, Merkur, Venus, Mars, Jupiter, Saturn, Uranus, Neptun, Pluto, Mean/True Node, Mean/Osculating Apogee (Lilith), Earth und Chiron. Default geozentrisch-tropisch; per Beobachtungs-Optionen siderisch bzw. helio-/bary-/topo-/planetozentrisch.
Parameter
| Name | In | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
datetime |
query | string | ja | ISO 8601, UTC (z.B. "2026-04-15T12:00:00Z") |
zodiac |
query | string | nein | "tropical" (Default) oder "sidereal". |
ayanamsa |
query | string | nein | Nur bei zodiac=sidereal. Default "lahiri". Katalog = SE_SIDM-Namen der Swiss Ephemeris (z.B. lahiri, fagan_bradley, krishnamurti, raman, true_citra). |
center |
query | string | nein | "geocentric" (Default), "heliocentric", "barycentric", "topocentric" oder "planet:<name>" (planetozentrisch, sun..pluto). Bei nicht-geozentrischen Zentren entfaellt das Zentrum aus der Koerperliste; "earth" wird zum regulaeren Faktor. |
observer_latitude / observer_longitude / observer_altitude |
query | number | nein | Beobachter-Ort, Pflicht bei center=topocentric. |
Beispiel-Aufruf
curl -sS \
-H "X-API-Key: ak_test_<DEIN_KEY>" \
"https://astroapi.services/v1/planets?datetime=2026-04-20T12%3A00%3A00Z"
<?php
$ch = curl_init("https://astroapi.services/v1/planets?datetime=2026-04-20T12%3A00%3A00Z");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: ak_test_<DEIN_KEY>"]);
$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->planets([
'datetime' => '2026-04-20T12:00:00Z',
]);
print_r($response);
const response = await fetch('https://astroapi.services/v1/planets?datetime=2026-04-20T12%3A00%3A00Z', {
method: 'GET',
headers: { 'X-API-Key': 'ak_test_<DEIN_KEY>' },
});
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.planets({
"datetime": "2026-04-20T12:00:00Z"
});
console.log(response);
import requests
url = 'https://astroapi.services/v1/planets?datetime=2026-04-20T12%3A00%3A00Z'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
response = requests.get(url, headers=headers)
print(response.json())
from astroapi_client import AstroApiClient
api = AstroApiClient('ak_test_<DEIN_KEY>')
response = api.planets({
'datetime': '2026-04-20T12:00:00Z',
})
print(response)