Guides API · 29.09.2026
Autocomplétion et validation d'adresses suisses avec une API
Ajoutez à vos formulaires l'autocomplétion des 3,3 millions d'adresses officielles suisses et vérifiez qu'une adresse existe, avec deux appels d'API.
Une adresse mal saisie coûte cher : colis retourné, facture qui n'arrive pas, client en doublon dans le CRM. En Suisse, la référence est le répertoire officiel des adresses de bâtiments publié par swisstopo : 3,3 millions d'adresses, chacune avec son identifiant fédéral. Le fichier brut pèse 470 Mo et utilise des coordonnées suisses (LV95). Notre API le rend utilisable en une requête.
1. Obtenir une clé
Créez un compte gratuit sur OpenData Altius : votre clé API est affichée dans votre tableau de bord. Chaque requête l'envoie dans l'en-tête Authorization.
2. Autocompléter pendant la saisie
Dès 3 caractères, l'API renvoie jusqu'à 10 adresses. Chaque mot tapé doit apparaître dans la rue, le numéro, le NPA ou la localité, dans n'importe quel ordre.
curl -H "Authorization: Token VOTRE_CLE" \
"https://opendata.altius-group.ch/geodata/addresses/api/v1/addresses/autocomplete/?q=echallens 6 froideville"
{"results": [{"full_address": "Route d'Echallens 6, 1055 Froideville",
"street": "Route d'Echallens", "number": "6", "zip_code": "1055",
"locality": "Froideville", "canton": "VD",
"latitude": 46.6003595, "longitude": 6.6735308}]}
Côté navigateur, appelez cette URL depuis votre serveur (pour ne pas exposer la clé), avec un délai de 200 ms entre deux frappes.
3. Valider une adresse saisie
Pour un formulaire déjà rempli, l'appel validate indique si l'adresse existe et, sinon, propose les plus proches dans le même NPA :
curl -H "Authorization: Token VOTRE_CLE" \
"https://opendata.altius-group.ch/geodata/addresses/api/v1/addresses/validate/?street=Route de Echallens&number=6&zip_code=1055"
La réponse contient "valid": false et, en premier, la suggestion Route d'Echallens 6, 1055 Froideville. Vous pouvez proposer la correction à l'utilisateur au lieu de refuser le formulaire.
4. Ce que vous obtenez en plus
- L'identifiant du bâtiment (EGID), qui relie l'adresse au Registre fédéral des bâtiments et des logements.
- Les coordonnées GPS, pour une carte ou un calcul de distance.
- La catégorie du bâtiment (habitation ou non).
Quotas
Le plan gratuit permet 100 requêtes par jour, suffisant pour tester et prototyper. Pour un formulaire en production, un plan payant lève ces limites. Les données sont mises à jour chaque semaine depuis swisstopo.