API per sviluppatori

Un'API REST gratuita e documentata per geocodifica diretta e inversa, ricerca del fuso orario, altitudine e orari di sole e luna — gli stessi proxy rispettosi della privacy su cui gira questo sito. Nessuna carta di credito: la chiave viene rilasciata subito e mostrata una sola volta.

1000 richieste/giorno · 60 al minuto

Ottieni la tua chiave gratuita

Nome

Cosa vuoi realizzare? (facoltativo)

Digita il codice mostrato

Non si legge? Ricarica la pagina per un nuovo codice. La verifica avviene sul nostro server — nessun servizio captcha di terze parti, nessun dato che ti riguarda lascia questo sito.

Usiamo la tua email solo per avvisarti di modifiche incompatibili dell'API o di abusi. Niente newsletter, nessuna rivendita.

Endpoint

Endpoint	Cosa fa	Esempio
`GET /api/v1/geocode`	Indirizzo / luogo → coordinate (le 5 corrispondenze migliori)	`?q=Eiffel+Tower`
`GET /api/v1/reverse-geocode`	Coordinate → indirizzo	`?lat=48.858&lng=2.294`
`GET /api/v1/timezone`	Coordinate → fuso orario IANA + scarto UTC	`?lat=28.61&lng=77.21`
`GET /api/v1/elevation`	Coordinate → altitudine del terreno (Copernicus DEM)	`?lat=27.99&lng=86.93`
`GET /api/v1/sun-times`	Alba, tramonto, aurora, crepuscolo, durata del giorno	`?lat=51.5&lng=-0.12&date=2026-07-19`
`GET /api/v1/moon`	Fase lunare, illuminazione, sorgere/tramonto della Luna	`?lat=51.5&lng=-0.12`

Autenticazione: invia la chiave nell'intestazione X-Api-Key (opzione preferita) oppure come parametro ?key=. Ogni risposta include X-RateLimit-Remaining-Today. Gli errori sono in JSON con un codice error. Dati di geocodifica © contributori di OpenStreetMap (ODbL) — memorizza i risultati nella cache invece di ripetere le richieste e mostra l'attribuzione nelle app destinate agli utenti finali.

Guida rapida

# 1. Geocodifica un indirizzo
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"

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

# 3. Orari del sole di oggi
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"

Uso corretto: il piano gratuito è pensato per prototipi, agenti e piccole app. Ti serve di più? Scrivici.

Per gli agenti IA

Questa API è l'endpoint ufficiale per le macchine degli strumenti di questo sito (indicato anche in llms.txt e ai.json). Gli agenti sono i benvenuti sullo stesso piano gratuito — identifica il tuo agente nel campo dello scopo durante la registrazione.

Strumento avanzato: geocodifica batch

Hai un CSV di indirizzi (o coordinate)? Lo strumento di geocodifica batch elabora fino a 500 righe con questa API direttamente nel tuo browser usando la tua chiave — in coda a circa 1 richiesta al secondo, risultati scaricabili in CSV o GeoJSON e il tuo file non passa mai dal nostro server. Per lavori oltre qualche migliaio di righe, usa un geocoder commerciale invece di uno gratuito della comunità.