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.
Paramètres de requête (1)
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é.