GET/api/astro/geocode/1 Credit

Ortssuche

Macht aus einem Ortsnamen die Koordinaten und den UTC-Offset, die die anderen Endpoints brauchen. Sende ein GET mit dem Query-Parameter `address`, etwa 'Jaipur, India', und du erhältst `latitude`, `longitude`, den IANA-Zeitzonennamen `timezone_name`, den Offset `timezone_offset` in Stunden als Dezimalzahl, den vom Geocoder gelieferten String `address` und die antwortende Quelle `source`. Der Offset berücksichtigt bereits die Sommerzeit, sofern der Anbieter sie meldet. Er ist also der aktuelle Offset für diesen Ort und nicht unbedingt der, der an einem historischen Geburtsdatum galt. Für ein Geburtshoroskop übergibst du die Koordinaten zusammen mit dem tatsächlichen Datum an /api/astro/date_time/; dieser Endpoint ermittelt dann den Offset für den richtigen Zeitpunkt. `source` zeigt, welcher Anbieter geantwortet hat: 'google', wenn für die Installation ein Google-Maps-Schlüssel konfiguriert ist, sonst 'nominatim', der OpenStreetMap-Dienst als Fallback. Wird ein Ort nicht gefunden, kommt 404 zurück; fehlt `address`, kommt 400 zurück.

https://api.occultapi.com/api/astro/geocode/

Anfrage testen

Authentifizierung

Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.

X-API-Key: yt_live_a1b2c3d4_…

Query-Parameter (1)

Sie stehen in der URL. Alle sind optional, sofern nicht anders markiert, und lassen sich kombinieren: erst filtern, dann blättern, dann sortieren.

Parameter	Typ		Beispiel	Bedeutung
address	string	Pflicht	`Jaipur, Rajasthan, India`	Gesuchter Stadt- oder Ortsname Gesuchter Ortsname. Freitext – meist genügt eine Stadt; für eine eindeutige Zuordnung ergänze Bundesstaat oder Land.

Beispielanfrage

curl "https://api.occultapi.com/api/astro/geocode/?address=Jaipur" \
  -H "X-API-Key: $OCCULT_API_KEY"

Antwort

{
  "address": "Jaipur, Rajasthan, India",
  "latitude": 26.9124336,
  "longitude": 75.7872709,
  "timezone_name": "Asia/Calcutta",
  "timezone_offset": 5.5,
  "source": "google"
}

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data.

Fehler

Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.