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.
Query-Parameter (1)
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.
