API pour développeurs

Une API REST gratuite et documentée pour le géocodage direct et inverse, la recherche de fuseau horaire, l'altitude et les horaires du soleil et de la lune — les mêmes relais respectueux de la vie privée que ceux qui font tourner ce site. Sans carte bancaire ; la clé est délivrée immédiatement et affichée une seule fois.

1000 requêtes/jour · 60 par minute

Obtenez votre clé gratuite

Nom

E-mail

Que voulez-vous construire ? (facultatif)

Saisissez le code affiché

Illisible ? Rechargez la page pour obtenir un nouveau code. La vérification se fait sur notre serveur — aucun service de captcha tiers, aucune information vous concernant ne quitte ce site.

Nous utilisons votre e-mail uniquement pour vous prévenir des changements incompatibles de l'API ou d'un usage abusif. Pas de newsletter, pas de revente.

Points de terminaison

Point de terminaison	Rôle	Exemple
`GET /api/v1/geocode`	Adresse / lieu → coordonnées (5 meilleurs résultats)	`?q=Eiffel+Tower`
`GET /api/v1/reverse-geocode`	Coordonnées → adresse	`?lat=48.858&lng=2.294`
`GET /api/v1/timezone`	Coordonnées → fuseau horaire IANA + décalage UTC	`?lat=28.61&lng=77.21`
`GET /api/v1/elevation`	Coordonnées → altitude du terrain (Copernicus DEM)	`?lat=27.99&lng=86.93`
`GET /api/v1/sun-times`	Lever, coucher du soleil, aube, crépuscule, durée du jour	`?lat=51.5&lng=-0.12&date=2026-07-19`
`GET /api/v1/moon`	Phase de la lune, illumination, lever/coucher de la lune	`?lat=51.5&lng=-0.12`

Authentification : envoyez la clé dans un en-tête X-Api-Key (recommandé) ou en paramètre ?key=. Chaque réponse inclut X-RateLimit-Remaining-Today. Les erreurs sont en JSON avec un code error. Données de géocodage © les contributeurs d'OpenStreetMap (ODbL) — mettez les résultats en cache plutôt que de relancer les requêtes, et affichez l'attribution dans les applications destinées aux utilisateurs finaux.

Démarrage rapide

# 1. Géocoder une adresse
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"

# 2. Géocodage inverse
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"

# 3. Horaires du soleil pour aujourd'hui
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"

Usage raisonnable : l'offre gratuite existe pour les prototypes, les agents et les petites applications. Besoin de plus ? Contactez-nous.

Pour les agents IA

Cette API est le point d'accès machine officiel des outils de ce site (également annoncé dans llms.txt et ai.json). Les agents sont les bienvenus sur la même offre gratuite — identifiez votre agent dans le champ « objectif » du formulaire d'inscription.

Outil avancé : géocodage par lot

Vous avez un CSV d'adresses (ou de coordonnées) ? L'outil de géocodage par lot traite jusqu'à 500 lignes via cette API directement dans votre navigateur avec votre clé — mis en file d'attente à ~1 requête/seconde, résultats téléchargeables en CSV ou GeoJSON, et votre fichier ne passe jamais par notre serveur. Au-delà de quelques milliers de lignes, utilisez un géocodeur commercial plutôt qu'un service communautaire gratuit.