Abgekürzte Straßennamen jetzt in der API verfügbar

Lange Straßennamen sind in manchen Systemen ein Problem. Feldlängen in ERP-Systemen, Etiketten auf Paketen, Adresszeilen auf Rechnungen — sie alle haben Grenzen. Deshalb führen wir das neue Feld streetShort ein: eine automatisch gekürzte Version des Straßennamens.

Was ist Straßennamen-Kürzung und warum ist sie nützlich?

Manche niederländischen Straßennamen sind auffallend lang. Die Eerste Jan van der Heijdenstraat in Amsterdam zählt 32 Zeichen. Systeme mit einer Feldgrenze von 24 Zeichen stoßen hier an ihre Grenzen.

Mit dem neuen Feld streetShort liefert die API automatisch eine gekürzte Version zurück:

Eerste Jan van der Heijdenstraat → 1e J. v.d. Heijdenstraat

Wie funktioniert es technisch?

Aktivieren Sie das neue Feld, indem Sie den Parameter shortening=1 mit Ihrem API-Aufruf mitsenden:

GET /lookup/v1/address/nl?postalcode=1234AB&number=10&shortening=1

Die Antwort enthält dann zusätzlich zum bestehenden Feld street ein neues Feld streetShort. Bestehende Felder werden nicht verändert.

Wie werden Straßennamen gekürzt?

Die Kürzungslogik folgt festen Regeln:

Die Kürzung ist konsistent und vorhersehbar — keine willkürliche Kürzung.

Vollständig optional und 100 % abwärtskompatibel

Bestehende Integrationen funktionieren ohne Anpassung. Das Feld streetShort erscheint nur dann in der Antwort, wenn Sie shortening=1 mitsenden. Sie können das Feld ignorieren oder es neben street verwenden.

Bald auch in unseren Plugins

Die Unterstützung für streetShort wird demnächst zu den WooCommerce-, Magento 2- und Contact-Form-7-Plugins hinzugefügt. Updates erfolgen automatisch.

Zusammengefasst

• Neues Feld: streetShort mit automatisch gekürztem Straßennamen
• Aktivierung über den Parameter shortening=1
• Abwärtskompatibel — keine Anpassungen am bestehenden Code nötig
• Konsistenter Kürzungsalgorithmus auf Basis von Sprachregeln