Guide API · 29.09.2026
Completamento e verifica degli indirizzi svizzeri via API
Aggiungete ai vostri moduli il completamento automatico dei 3,3 milioni di indirizzi ufficiali svizzeri e verificate che un indirizzo esista, con due chiamate API.
Un indirizzo sbagliato costa: pacchi rispediti, fatture che non arrivano, clienti doppi nel CRM. In Svizzera il riferimento è l'elenco ufficiale degli indirizzi degli edifici pubblicato da swisstopo: 3,3 milioni di indirizzi, ognuno con un identificativo federale. Il file grezzo pesa 470 MB e usa coordinate svizzere (LV95). La nostra API lo rende utilizzabile con una sola richiesta.
1. Ottenere una chiave
Create un account gratuito su OpenData Altius: la chiave API è nel vostro pannello. Ogni richiesta la invia nell'intestazione Authorization.
2. Completare durante la digitazione
Da 3 caratteri l'API restituisce fino a 10 indirizzi. Ogni parola digitata deve comparire nella via, nel numero, nel NPA o nella località, in qualsiasi ordine.
curl -H "Authorization: Token VOSTRA_CHIAVE" \
"https://opendata.altius-group.ch/geodata/addresses/api/v1/addresses/autocomplete/?q=via cantonale lugano"
Chiamate l'URL dal vostro server (per non esporre la chiave nel browser) e attendete 200 ms tra due battute.
3. Verificare un indirizzo inserito
Per un modulo già compilato, la chiamata validate indica se l'indirizzo esiste e, altrimenti, propone i più vicini nello stesso NPA:
curl -H "Authorization: Token VOSTRA_CHIAVE" \
"https://opendata.altius-group.ch/geodata/addresses/api/v1/addresses/validate/?street=Route de Echallens&number=6&zip_code=1055"
La risposta contiene "valid": false e, come primo suggerimento, Route d'Echallens 6, 1055 Froideville. Potete proporre la correzione invece di rifiutare il modulo.
4. Cosa ottenete in più
- L'identificativo dell'edificio (EGID), che collega l'indirizzo al Registro federale degli edifici e delle abitazioni.
- Le coordinate GPS, per una mappa o un calcolo di distanza.
- La categoria dell'edificio (abitativo o no).
Quote
Il piano gratuito consente 100 richieste al giorno, sufficienti per testare. Per un modulo in produzione, un piano a pagamento toglie questi limiti. I dati sono aggiornati ogni settimana da swisstopo.