API-Anleitungen · 29.09.2026
Schweizer Adressen per API vervollständigen und prüfen
Autovervollständigung der 3,3 Millionen amtlichen Schweizer Adressen in Ihren Formularen und Prüfung, ob eine Adresse existiert – mit zwei API-Aufrufen.
Eine falsch erfasste Adresse kostet: retournierte Pakete, Rechnungen, die nicht ankommen, doppelte Kunden im CRM. In der Schweiz ist das amtliche Gebäudeadressverzeichnis von swisstopo die Referenz: 3,3 Millionen Adressen, jede mit eidgenössischem Identifikator. Die Rohdatei ist 470 MB gross und verwendet Schweizer Koordinaten (LV95). Unsere API macht sie mit einer einzigen Abfrage nutzbar.
1. Schlüssel beziehen
Erstellen Sie ein kostenloses Konto bei OpenData Altius: Ihr API-Schlüssel steht im Dashboard. Jede Abfrage sendet ihn im Header Authorization.
2. Während der Eingabe vervollständigen
Ab 3 Zeichen liefert die API bis zu 10 Adressen. Jedes eingegebene Wort muss in Strasse, Nummer, PLZ oder Ort vorkommen, in beliebiger Reihenfolge.
curl -H "Authorization: Token IHR_SCHLUESSEL" \
"https://opendata.altius-group.ch/geodata/addresses/api/v1/addresses/autocomplete/?q=bahnhofstrasse 1 zürich"
Rufen Sie die URL von Ihrem Server aus auf (damit der Schlüssel nicht im Browser sichtbar ist) und warten Sie 200 ms zwischen zwei Tastenanschlägen.
3. Eine erfasste Adresse prüfen
Für ein ausgefülltes Formular sagt der Aufruf validate, ob die Adresse existiert, und schlägt sonst die ähnlichsten Adressen derselben PLZ vor:
curl -H "Authorization: Token IHR_SCHLUESSEL" \
"https://opendata.altius-group.ch/geodata/addresses/api/v1/addresses/validate/?street=Route de Echallens&number=6&zip_code=1055"
Die Antwort enthält "valid": false und als ersten Vorschlag Route d'Echallens 6, 1055 Froideville. So können Sie die Korrektur anbieten, statt das Formular abzulehnen.
4. Was Sie zusätzlich erhalten
- Den Gebäudeidentifikator (EGID), der die Adresse mit dem eidgenössischen Gebäude- und Wohnungsregister verbindet.
- GPS-Koordinaten für Karten oder Distanzberechnungen.
- Die Gebäudekategorie (Wohnnutzung oder nicht).
Kontingente
Der Gratisplan erlaubt 100 Abfragen pro Tag – genug zum Testen. Für ein Formular im Produktivbetrieb hebt ein kostenpflichtiger Plan diese Grenzen auf. Die Daten werden wöchentlich von swisstopo aktualisiert.