Afgekorte straatnamen nu beschikbaar in de API

Lange straatnamen zijn in sommige systemen een probleem. Veldlengtes in ERP-systemen, labels op pakketjes, adresregels op facturen — ze hebben allemaal limieten. Daarom introduceren we het nieuwe veld streetShort: een automatisch afgekorte versie van de straatnaam.

Wat is straatnaam-verkorting en waarom is het handig?

Sommige Nederlandse straatnamen zijn opvallend lang. De Eerste Jan van der Heijdenstraat in Amsterdam telt 32 tekens. Systemen met een veldlimiet van 24 tekens lopen hier tegenaan.

Met het nieuwe streetShort-veld retourneert de API automatisch een afgekorte versie:

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

Hoe werkt het technisch?

Activeer het nieuwe veld door de parameter shortening=1 mee te sturen met je API-aanroep:

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

De respons bevat dan een extra veld streetShort naast het bestaande street-veld. Bestaande velden worden niet gewijzigd.

Hoe worden straatnamen afgekort?

De afkortingslogica volgt vaste regels:

De afkorting is consistent en voorspelbaar — geen willekeurige truncatie.

Volledig optioneel en 100% backward compatible

Bestaande integraties werken zonder aanpassing. Het veld streetShort verschijnt alleen in de respons als je shortening=1 meegeeft. Je kunt het veld negeren of het naast street gebruiken.

Binnenkort ook in onze plugins

Ondersteuning voor streetShort wordt binnenkort toegevoegd aan de WooCommerce-, Magento 2- en Contact Form 7-plugins. Updates volgen automatisch.

Samengevat

• Nieuw veld: streetShort met automatisch afgekorte straatnaam
• Activeren via parameter shortening=1
• Backward compatible — geen aanpassingen nodig aan bestaande code
• Consistent afkortingsalgoritme op basis van taalregels