We hebben een krachtige nieuwe functie toegevoegd aan onze Address Lookup API: het automatisch afkorten van straatnamen met behulp van het veld StreetShort. Deze uitbreiding maakt het mogelijk om compacte straatnamen op te halen. Wanneer een gebruiker een verkorting intypt wordt deze ook herkent door ons systeem.
Het mooiste? Deze functionaliteit is niet alleen beschikbaar via de API, maar zal binnenkort ook worden geïntegreerd in al onze officiële plugins. Bij elke eerstvolgende update wordt dit automatisch meegenomen. Vanuit verschillende klanten is dit verzoek gekomen en door onze technisch team is dit nu ook in onze adres database doorgevoerd.
👉 Bekijk de technische documentatie
Wat is straatnaam-verkorting en waarom is het handig?
Sommige Nederlandse straatnamen zijn bijzonder lang – denk aan “Eerste Jan van der Heijdenstraat” of “Professor Doctor P. J. Meertensstraat”. Dat zorgt voor uitdagingen op mobiele schermen, verzendlabels en kassabonnen. Met streetShort los je dit elegant op: je toont een kortere versie van de straatnaam, zonder dat je de originele gegevens hoeft aan te passen.
Het resultaat: een strakke interface én volledig correcte adresdata, daarnaast is het nu mogelijk voor gebruikers om bij een check-out de afkorting als adres in te vullen en wordt deze ook herkend.
Hoe werkt het technisch?
De uitbreiding werkt via één simpele toevoeging aan je API-call. Door shortening=1 toe te voegen aan je request, krijg je een extra veld streetShort in de response terug:
Zonder afkorting:
GET https://api.apicheck.nl/lookup/v1/postalcode/nl?postalcode=1234+AB&number=42
Met afkorting:
GET https://api.apicheck.nl/lookup/v1/postalcode/nl?postalcode=1234+AB&number=42&shortening=1
Response met shortening=1
“street”: “Eerste Jan van der Heijdenstraat”,
“streetShort”: “1e J. v.d. Heijdenstraat”
De originele straatnaam blijft onveranderd; streetShort is aanvullend en bedoeld voor compacte weergave.
Hoe worden straatnamen afgekort?
Onze afkortingslogica is ontworpen voor veiligheid én leesbaarheid:
- Ordinalen: “Eerste” → “1e”, “Tweede” → “2e”
- Titels: “Professor” → “Prof.”, “Dokter” → “Dr.”, “Sint” → “St.”
- Voorzetsels: “Van de” → “v.d.”, “Ten” → “t.”
- Voorletters: “Jan Willem” → “J.W.”
- Uitzonderingen: Ambigue namen zoals “De Duivenvlucht” blijven ongewijzigd
Deze aanpak voorkomt fouten en zorgt dat straatnamen altijd herkenbaar blijven.
Volledig optioneel en 100% backward compatible
Gebruik je shortening=1, dan krijg je streetShort erbij. Laat je deze parameter weg, dan verandert er niets. Je huidige integraties blijven dus volledig werken zonder aanpassingen.
Deze functie is optioneel en heeft geen invloed op adresmatching of zoekfunctionaliteit.
Binnenkort ook beschikbaar in onze plugins
Werk je met één van onze officiële plugins, zoals:
- WooCommerce Postcode Plugin
- Magento 2 adresvalidatie
- Contact Form 7-integratie
Dan hebben we goed nieuws: bij de eerstvolgende update van iedere plugin voegen we deze streetShort functionaliteit toe. Hierdoor kun je straks ook in je webshop of formulier kiezen voor compacte straatweergave, zonder zelf code te schrijven.
Samengevat: dit is waarom streetShort handig is
✅ Compacte weergave op mobiele schermen, labels of kassa’s
✅ Eén simpele parameter in de API-call
✅ Volledige backward compatibility
✅ Binnenkort automatisch in alle plugins beschikbaar
✅ Geen impact op matching of validatie
Klaar om het zelf te proberen?
Gebruik je al de Lookup API? Voeg shortening=1 toe aan je request en ontvang direct het extra veld streetShort.
Meer technische details vind je in onze officiële documentatie bekijk: https://docs.apicheck.nl/blog/api-street-name-shortening
Wil je dit ook gebruiken in je plugin? Dan hoef je alleen te updaten zodra een nieuwe versie beschikbaar is, wij doen de rest.
Heb je vragen of suggesties? Neem gerust contact met ons op. Ons team helpt je graag verder!