API pentru dezvoltatori

Un API REST gratuit și documentat pentru geocodare directă, geocodare inversă, aflarea fusului orar, altitudine și orele Soarelui și ale Lunii — aceleași proxy-uri care respectă confidențialitatea și pe care rulează acest site. Fără card bancar; cheia este emisă instantaneu și afișată o singură dată.

1000 cereri/zi · 60 pe minut

Obține cheia ta gratuită

Nume

E-mail

Ce vei construi? (opțional)

Scrie codul afișat

Nu se citește? Reîncarcă pagina pentru un cod nou. Verificarea se face pe serverul nostru — fără servicii captcha de la terți, nimic despre tine nu părăsește acest site.

Folosim adresa ta de e-mail doar ca să te anunțăm despre modificări incompatibile ale API-ului sau despre abuzuri. Fără buletine informative, fără revânzare.

Endpointuri

Endpoint	Ce face	Exemplu
`GET /api/v1/geocode`	Adresă / loc → coordonate (primele 5 potriviri)	`?q=Eiffel+Tower`
`GET /api/v1/reverse-geocode`	Coordonate → adresă	`?lat=48.858&lng=2.294`
`GET /api/v1/timezone`	Coordonate → fus orar IANA + decalaj UTC	`?lat=28.61&lng=77.21`
`GET /api/v1/elevation`	Coordonate → altitudinea terenului (Copernicus DEM)	`?lat=27.99&lng=86.93`
`GET /api/v1/sun-times`	Răsărit, apus, zori, amurg, durata zilei	`?lat=51.5&lng=-0.12&date=2026-07-19`
`GET /api/v1/moon`	Faza Lunii, iluminare, răsăritul/apusul Lunii	`?lat=51.5&lng=-0.12`

Autentificare: trimite cheia ca antet X-Api-Key (recomandat) sau ca parametru ?key=. Fiecare răspuns include X-RateLimit-Remaining-Today. Erorile sunt JSON, cu un cod error. Date de geocodare © contribuitorii OpenStreetMap (ODbL) — păstrează rezultatele în cache în loc să repeți interogările și afișează atribuirea în aplicațiile pentru utilizatori.

Start rapid

# 1. Geocodează o adresă
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"

# 2. Geocodare inversă
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"

# 3. Orele Soarelui pentru azi
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"

Utilizare corectă: nivelul gratuit există pentru prototipuri, agenți și aplicații mici. Ai nevoie de mai mult? Scrie-ne.

Pentru agenți IA

Acest API este endpointul oficial pentru mașini al instrumentelor de pe acest site (anunțat și în llms.txt și ai.json). Agenții sunt bineveniți pe același nivel gratuit — identifică-ți agentul în câmpul de scop de la înregistrare.

Instrument avansat: geocodare în masă

Ai un CSV cu adrese (sau coordonate)? Folosește instrumentul de geocodare în masă: trece până la 500 de rânduri prin acest API direct în browserul tău, cu cheia ta — la o cadență politicoasă de ~1 cerere/secundă, cu rezultate descărcabile în CSV sau GeoJSON, iar fișierul tău nu ajunge niciodată pe serverul nostru. Pentru lucrări de peste câteva mii de rânduri, folosește un geocodificator comercial, nu unul comunitar gratuit.