Was ist Adressnormalisierung?

Rohtext hinein. Geprüfte Adresse heraus.

Echte Nutzer tippen Adressen nicht so, wie Ihre Datenbank sie erwartet. Sie kürzen ab, machen Tippfehler, vertauschen Felder oder schreiben einfach drauflos. Der Normalisierungs-Endpoint wandelt dieses Rauschen in eine präzise, strukturierte Adresse um — validiert gegen das offizielle Schweizer Bundesregister.

Rechtschreibkorrektur

"Zurich" wird zu "Zürich". "Bahnhofstr" wird zu "Bahnhofstrasse". Tippfehler und Abkürzungen werden automatisch aufgelöst.

Strukturextraktion

Ein unstrukturierter String wird in Strasse, Hausnummer, PLZ, Ort, Gemeinde und Kanton aufgeteilt — jedes in einem dedizierten Feld.

Bundesregister-Abgleich

Das Ergebnis wird gegen die RegBL- und swisstopo-Register abgeglichen. Nur echte, existierende Schweizer Adressen bestehen.

Konfidenz-Scoring

Jedes Ergebnis enthält einen Präzisionswert. Mehrdeutige Treffer liefern gerankte Kandidaten, damit der Nutzer bestätigen kann.

Datensouveränität & Datenschutz

Ihre Adressen bleiben auf unserer Schweizer Infrastruktur

Die Normalisierungspipeline läuft Ende-zu-Ende in der Schweiz. Eingereichte Adressen werden nicht zur Inferenz an externe Dienste weitergeleitet.

Kurze Antwort: Nein, Ihre Adressdaten werden nicht an Inferenzdienste Dritter gesendet.

Wenn Sie HelvAddress nutzen, wird der Request-Body auf unserer Infrastruktur in der Schweiz verarbeitet. Wir leiten eingereichte Adressen weder an externe KI-Anbieter noch an externe Geocoding-Dienste oder ausserhalb der Schweiz gehostete APIs zur Normalisierung weiter.

Normalisierungspfad ausschliesslich in der Schweiz
Keine LLMs oder generativen Modelle im Request-Flow
Einfachere Datenschutz- und Lieferantenrisikoprüfungen

Konkret laufen Eingabeverständnis, Ortsauflösung, Strassensuche, Verfeinerung bis auf Gebäudeebene und Konfidenzbewertung auf unseren eigenen Servern in der Schweiz.

Technische Dienstleister, die wir für Hosting oder Betrieb einsetzen, sind nicht Teil der Normalisierungs-Engine und erhalten keine Request-Bodies für KI-Verarbeitung oder Anreicherung durch Dritte.

Unsere Infrastruktur wird in der Schweiz bei Infomaniak gehostet. Siehe: Datenschutzerklärung von Infomaniak

Privacy & Data Sovereignty lesen
Was das für Ihre Teams bedeutet

Keine Übertragung von Adressen an Geocoding-APIs, LLMs oder generative Modelle Dritter

Verarbeitung, operative Protokollierung und Governance bleiben unter Schweizer Kontrolle

Eine einfachere Grundlage für Datenschutz-, Compliance- und Risikoprüfungen

Schweizer Normalisierungsarchitektur Ihre Eingabe Freitextadresse HelvAddress-Verarbeitung in der Schweiz Analyse, Matching, Scoring Auf unserem Schweizer Stack Externe Dienste Keine Adresse verlässt den Stack
Schweizer Adressintelligenz

Adressintelligenz für die Schweiz entwickelt

Eine Schweizer Adresse zu normalisieren bedeutet mehr als Tippfehler zu korrigieren. Es geht auch um reale Schreibweisen, Abkürzungen, Mehrsprachigkeit, vertauschte Reihenfolgen und landesspezifische Mehrdeutigkeiten.

Unsere Engine verwandelt Freitext, unvollständige oder ungenaue Eingaben in strukturierte, verlässliche und nutzbare Adressen. Gleichzeitig qualifiziert sie das Resultat, damit Ihre Systeme wissen, wann sie akzeptieren, wann sie nachfragen und wann sie ablehnen sollen.

1
1. Eingabe verstehen

Die Engine harmonisiert zunächst die Schreibweise, damit sie von einer konsistenten Basis ausgehen kann – auch wenn die Eingabe unvollständig, verrauscht oder unregelmässig ist.

2
2. Die richtigen Bestandteile erkennen

Anschliessend erkennt sie die relevanten Komponenten – Ort, PLZ, Strasse, Hausnummer und Kontextsignale – ohne eine feste Reihenfolge zu verlangen.

3
3. Die Adresse in den Schweizer Kontext setzen

Der Ort wird unter Berücksichtigung geografischer und sprachlicher Realitäten der Schweiz aufgelöst, um Mehrdeutigkeiten so früh wie möglich zu reduzieren.

4
4. Strasse finden und Treffer verfeinern

Die Strasse wird im richtigen territorialen Kontext gesucht; wenn die Daten es erlauben, kann die Auflösung bis auf das Gebäude verfeinert werden.

5
5. Ergebnis qualifizieren

Jeder Treffer wird bewertet, damit nicht nur eine normalisierte Adresse zurückkommt, sondern auch Präzisionsstufe, Konfidenzwert und bei Bedarf sinnvolle Alternativen.

Ergebnis: Aus einer Freitextadresse werden konsistente, produktionsreife Daten für Datenqualität, User Experience, Geocoding, Compliance und operative Automatisierung.

Anwendungsfälle

Wo Normalisierung den Unterschied macht

Jedes System, das Schweizer Adressen erfasst oder speichert, profitiert von der Normalisierung.

E-Commerce & Checkout

Kunden tippen Adressen schnell und ungenau. Normalisieren Sie beim Checkout, um Lieferfehler zu eliminieren, Rücksendungen zu reduzieren und Ihre Logistikmarge zu schützen.

CRM & Kundendaten

Importierte Kontakte, migrierte Datenbanken oder manuell erfasste Datensätze enthalten alle Inkonsistenzen. Ein einziger Normalisierungsdurchlauf erzeugt einen sauberen, deduplizierten Adressstamm.

Betrugserkennung

Betrügerische Bestellungen verwenden oft leicht veränderte oder nicht existierende Adressen. Die Normalisierung gegen das Bundesregister deckt ungültige Adressen auf, die einfache Formatprüfungen umgehen.

ERP & Logistiksysteme

Tourenplanung und Paketversand erfordern strukturierte Daten. Die Normalisierung wandelt Freitexteingaben von Aussendienstmitarbeitern oder Legacy-Formularen in maschinenlesbare Datensätze um.

Post & Dokumentenservices

Gedruckte Post, Rechnungen und Verträge müssen den richtigen Empfänger erreichen. Normalisieren Sie vor der Dokumentenerstellung, um unzustellbare Korrespondenz zu vermeiden.

KYC & Onboarding

Banken, Versicherungen und Fintech-Plattformen müssen Kundenadressen beim Onboarding verifizieren. Die Normalisierung gegen das offizielle Register liefert einen überprüfbaren, zeitgestempelten Nachweis der Adressvalidierung.

Batch Job API

Zehntausende Adressen asynchron normalisieren

Übermitteln Sie grosse Schweizer Adressbestände in einem einzigen API-Aufruf und lassen Sie HelvAddress sie im Hintergrund verarbeiten – ohne Timeouts, manuelle Retries oder operative Workarounds.

Die Ausführungspriorität wird automatisch anhand der Batch-Grösse vergeben. Kleine Jobs kommen schnell zurück, während grössere Volumen durch dedizierte Queues für Data-Quality-Workflows mit hohem Durchsatz laufen.

LIGHT ≤ 1 000
LIGHT-Jobs laufen zuerst

Bis zu 1'000 Adressen. Ideal für schnelle Bereinigungen, Vorabprüfungen vor Imports und operative Jobs mit Resultaten innert Sekunden.

MEDIUM ≤ 10 000
MEDIUM-Jobs nutzen eine eigene Queue

Bis zu 10'000 Adressen. Perfekt für CRM-Exporte, Partnerimporte und wiederkehrende Datenbank-Hygieneprozesse.

HEAVY > 10 000
HEAVY-Jobs werden planbar verarbeitet

Mehr als 10'000 Adressen. Entwickelt für grosse Migrationen und die Bereinigung von Stammdaten, ohne Echtzeitverkehr zu beeinträchtigen.

1
1. Ein JSON-Payload senden

Senden Sie eine vollständige Liste freier Schweizer Adressen an den Batch-Endpoint. HelvAddress erstellt daraus einen Hintergrundjob und weist automatisch die passende Prioritätsstufe zu.

2
2. Fortschritt live verfolgen

Über den Status-Endpoint verfolgen Sie `progressPercent`, `processedItems`, `failedItems` und `pendingItems` in Echtzeit aus ERP-, ETL- oder Backoffice-Prozessen.

3
3. Resultate abrufen, wenn der Job fertig ist

Sobald der Job abgeschlossen ist, laden Sie die normalisierten Ergebnisse herunter und speisen sie direkt in Ihre CRM-Migration, Kundenbereinigung oder Import-Pipeline ein.

Batch-Submission
POST /api/jobs/normalize
Authorization: Bearer {access_token}
Content-Type: application/json
X-HelvAddress-API-Version: 1.0.0

{
  "items": [
    {
      "id": "row-001",
      "address": "Bahnhofstr 1, 8001 zurich"
    },
    {
      "id": "row-002",
      "address": "1003 Lausanne, av gare 12"
    },
    {
      "id": "row-003",
      "address": "Grand- 22, 1470 Estavayer-le-Lac"
    }
  ]
}
Live-Statusantwort
{
  "jobId": "8a5f2b0d-4f1f-4a48-85d7-b8d6bca2e840",
  "status": "PROCESSING",
  "level": "LIGHT",
  "totalItems": 3,
  "processedItems": 2,
  "failedItems": 0,
  "pendingItems": 1,
  "progressPercent": 66.67,
  "createdAt": "2026-03-22T10:00:00Z",
  "startedAt": "2026-03-22T10:00:02Z"
}
Antwort bei Annahme
{
  "jobId": "8a5f2b0d-4f1f-4a48-85d7-b8d6bca2e840",
  "level": "LIGHT",
  "totalItems": 3,
  "statusUrl": "/api/jobs/8a5f2b0d-4f1f-4a48-85d7-b8d6bca2e840",
  "resultsUrl": "/api/jobs/8a5f2b0d-4f1f-4a48-85d7-b8d6bca2e840/results"
}
Business-Nutzen

Die Batch Job API ist für Teams gebaut, die Schweizer Adressqualität im grossen Massstab brauchen – nicht nur Request für Request.

CRM- und ERP-Migrationen ohne Timeout-Risiko automatisieren
Legacy-Kundendateien vor Import oder Deduplizierung bereinigen
Fortschritt präzise für Operations- und Support-Teams verfolgen
API-Integration

Einfach zu integrieren. Unter der Haube hochentwickelt.

Senden Sie eine Adresse als Klartext und erhalten Sie strukturierte JSON-Daten zurück. Die Normalisierungspipeline läuft vollständig auf unserer Schweizer Infrastruktur.

1
Rohadresse senden

POST einer beliebigen Adresse als Nur-Text. Kein JSON-Wrapping, kein Feld-Mapping erforderlich.

2
Engine analysiert & gleicht ab

Unsere in der Schweiz gehostete Engine tokenisiert, korrigiert und gleicht die Adresse mit den offiziellen Registern ab – ohne die Eingabe an externe Inferenzdienste weiterzuleiten.

3
Strukturiertes Ergebnis erhalten

Erhalten Sie eine normalisierte Adresse mit allen Feldern, einem Konfidenzwert, angewendeten Korrekturen und eventuellen alternativen Kandidaten.

Request
POST /api/addresses/normalize
Authorization: Bearer {access_token}
Content-Type: text/plain
X-HelvAddress-API-Version: 1.0.0

Grand- 22, 1470 Estavayer-le-Lac
Response
{
  "status": "MATCHED",
  "best": {
    "score": 0.85,
    "precision": "BUILDING",
    "normalized": {
      "streetName": "Grand-Rue",
      "houseNumber": "22",
      "zip4": 1470,
      "zipa": 0,
      "locality": "Estavayer-le-Lac",
      "municipality": "Estavayer",
      "lines": [
        "Grand-Rue 22",
        "1470 Estavayer-le-Lac"
      ]
    },
    "changes": [
      {
        "field": "STREET_NAME",
        "from": "Grand",
        "to": "Grand-Rue",
        "type": "STREET_TYPE_CORRECTION",
        "impact": 0.1
      }
    ],
    "meta": {
      "egaid": 101045004,
      "canton": "FR"
    }
  },
  "candidates": [],
  "issues": [],
  "dataVersion": "2026-03-14"
}
Vom Eingang bis zur Antwort bleibt der Request-Body innerhalb unserer Schweizer Verarbeitungsumgebung und wird nicht an Inferenzdienste Dritter übertragen.
Praxisbeispiele

Sehen Sie, was die API mit echten Eingaben macht

Von der rohen Nutzereingabe zu produktionsreifen Daten.

Eingabe Typo + abbreviation

bahnhofstr 1 zurick

Status: MATCHED Präzision: BUILDING  ·  Score: 0.70

Bahnhofstrasse 1

8001 Zürich · ZH

Angewendete Korrektur:

bahnhofstr → Bahnhofstrasse

zurick → Zürich

Eingabe Unordered fields

1003 Lausanne, av gare 12

Status: MATCHED Präzision: BUILDING  ·  Score: 0.8

Avenue de la Gare 12

1003 Lausanne · VD

Angewendete Korrektur:

av gare → Avenue de la Gare

Fields reordered

Eingabe Missing house number (ambiguous)

Route de Berne, 1000 Lausanne

Status: AMBIGUOUS Präzision: STREET

Multiple candidates returned — user confirmation recommended

Route de Berne 1, 1000 Lausanne

Route de Berne 2, 1000 Lausanne

Route de Berne 6, 1000 Lausanne

...

Eingabe Entirely made-up address

Rue du Château 99, 9999 Fakestadt

Status: NOT_FOUND Score: 0.00

No match found in the Swiss federal register. This address does not exist — ideal signal for fraud detection or data quality workflows.

API-Antwortstruktur

Alles, was Sie brauchen, in einer einzigen Antwort

Die Normalisierungsantwort ist so konzipiert, dass sie sofort verwendbar ist — ohne weitere Lookups.

Field Type Description
statusstringMATCHED · AMBIGUOUS · NOT_FOUND · INVALID_INPUT · INTERNAL_ERROR
bestobjectBest candidate when a reliable match exists
best.scorefloatMatch confidence from 0.0 to 1.0
best.precisionstringPOSTAL · STREET · BUILDING
best.normalizedobjectStructured normalized Swiss address
best.changesarrayField-level changes applied during normalization
candidatesarrayAlternative candidates returned when status is AMBIGUOUS
issuesarrayWarnings explaining uncertainty or parsing limits
dataVersionstringBuilding datasource version used for matching
Status values

MATCHED Unique, high-confidence result

AMBIGUOUS Multiple candidates — present choices to user

NOT_FOUND No match in federal register

INVALID_INPUT Input could not be parsed reliably

INTERNAL_ERROR Unexpected server-side normalization failure

Full response example
{
  "status": "MATCHED",
  "best": {
    "score": 0.9812,
    "precision": "BUILDING",
    "normalized": {
      "streetName": "Bahnhofstrasse",
      "houseNumber": "1",
      "zip4": 8001,
      "zipa": 0,
      "locality": "Zürich",
      "municipality": "Zürich",
      "lines": [
        "Bahnhofstrasse 1",
        "8001 Zürich"
      ],
      "lat": 47.376887,
      "lng": 8.541694
    },
    "changes": [
      {
        "field": "STREET_NAME",
        "from": "bahnhofstr",
        "to": "Bahnhofstrasse",
        "type": "ABBREVIATION_EXPANSION",
        "impact": 0.03
      },
      {
        "field": "CITY",
        "from": "zurick",
        "to": "Zürich",
        "type": "SPELLING_CORRECTION",
        "impact": 0.02
      }
    ],
    "meta": {
      "egaid": 100497285,
      "canton": "ZH"
    }
  },
  "candidates": [],
  "issues": [],
  "dataVersion": "2026-03-14"
}

Bereit, Ihre Adressdaten zu bereinigen?

Die Adressnormalisierung ist im Business-Plan enthalten. Probieren Sie die Live-Demo oder lesen Sie die API-Dokumentation für den Einstieg.

Live-Demo ausprobieren API-Referenz Pläne ansehen