API Geocoding Italia

Geocoding diretto e inverso su ~18,7 milioni di indirizzi italiani, integrato con i dati catastali.

Trasforma indirizzi in coordinate e coordinate in indirizzi con la base ANNCSU OpenAddresses, e passa senza soluzione di continuità dal civico alla particella catastale. Il geocoding inverso supporta raggio personalizzato fino a 500 metri.

Crea il tuo token API gratuito

Esempio: geocoding diretto di Via del Corso a Roma

curl --request GET \
  --url 'https://api.zornade.com/api/v2/geocode/search?q=Via+del+Corso&city=Roma&limit=10' \
  --header 'x-api-key: zrn_IL_TUO_TOKEN'

Risposta (abbreviata):

{
  "data": [
    {
      "address_id": 123456,
      "street_name": "Via Del Corso",
      "street_number": "1",
      "locality": "Roma",
      "municipality_code": "H501",
      "municipality_name": "Roma",
      "province": "Roma",
      "region": "Lazio",
      "latitude": 41.9028,
      "longitude": 12.4964,
      "formatted_address": "Via Del Corso 1, Roma, Roma"
    }
  ],
  "meta": { "query": "Via del Corso", "city": "Roma", "count": 1 }
}

Endpoint coinvolti

GET/api/v2/geocode/search?q=...&city=...&limit=...

Geocoding diretto per testo, con filtro città opzionale e fino a 50 risultati.

GET/api/v2/geocode/reverse?lat=...&lng=...&radius=...

Geocoding inverso da coordinate, raggio fino a 500 metri.

GET/api/v2/parcels/locate?lat=...&lng=...

Dalle coordinate del geocoding alla particella catastale corrispondente.

Casi d'uso tipici

Form di ricerca immobiliare

Autocompletamento e normalizzazione degli indirizzi con CAP, provincia e coordinate certe.

Geolocalizzazione CRM

Porta su mappa i clienti da un indirizzo libero, senza duplicati e con la particella collegata.

Logistica e delivery

Coordinate affidabili degli indirizzi italiani, comprese le zone con civici non standard.

Catasto da indirizzo

Dall'indirizzo alla particella in due chiamate: geocoding e poi parcels/locate.

Domande frequenti

Quanti indirizzi copre il geocoding?

Circa 18,7 milioni di indirizzi italiani dalla base ANNCSU OpenAddresses, copertura aggiornata periodicamente.

Il geocoding funziona con i civici complessi?

Sì, gestisce esponenti e località: il dettaglio particella espone la lista completa degli indirizzi associati.

Quale scope serve?

Il token deve avere lo scope geocoding:read, selezionabile in fase di creazione su app.zornade.com/api.