/api/astro/geocode/1 créditRecherche de lieu
Convertit un nom de lieu en coordonnées et en décalage UTC, les données dont ont besoin les autres endpoints. Envoyez un GET avec un paramètre de requête `address`, par exemple 'Jaipur, India' : vous recevez `latitude`, `longitude`, le `timezone_name` IANA, le `timezone_offset` en heures sous forme décimale, la chaîne `address` renvoyée par le géocodeur et la `source` qui a répondu. Le décalage tient déjà compte de l’heure d’été lorsque le fournisseur l’indique : c’est donc le décalage actuel du lieu, et pas forcément celui qui s’appliquait à une date de naissance passée. Pour un thème natal, passez ces coordonnées à /api/astro/date_time/ avec la date réelle, et laissez cet endpoint déterminer le décalage valable à ce moment-là. `source` indique quel fournisseur a répondu : 'google' si une clé Google Maps est configurée pour le déploiement, sinon 'nominatim', le service OpenStreetMap utilisé en solution de repli. Un lieu introuvable renvoie une erreur 404, et une requête sans `address` une erreur 400.
https://api.occultapi.com/api/astro/geocode/Authentification
Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.
X-API-Key: yt_live_a1b2c3d4_…Paramètres de requête (1)
Ils se passent dans l’URL. Tous sont facultatifs sauf mention contraire, et ils se combinent : filtrage, puis pagination, puis tri.
| Paramètre | Type | Exemple | Rôle | |
|---|---|---|---|---|
| address | string | obligatoire | Jaipur, Rajasthan, India | Le nom de ville ou de lieu à rechercher Le nom du lieu à rechercher. Texte libre - une ville suffit en général ; ajoutez l’État ou le pays pour lever toute ambiguïté. |
Exemple de requête
curl "https://api.occultapi.com/api/astro/geocode/?address=Jaipur" \
-H "X-API-Key: $OCCULT_API_KEY"Réponse
{
"address": "Jaipur, Rajasthan, India",
"latitude": 26.9124336,
"longitude": 75.7872709,
"timezone_name": "Asia/Calcutta",
"timezone_offset": 5.5,
"source": "google"
}Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.
Erreurs
Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.