Dutch Address

dutchAddressRangePostcodeSearch

Determine if a specific address exists using the unique ‘1234AA12’ postcode + house number format. If returns either the full address in DutchAddressPostcodeRange format, or an error if no matching address exists.

Migrating from Address::addressReeksPostcodeSearch

This method provides the same basic functionality as Address::addressReeksPostcodeSearch. If you currently use addressReeksPostcodeSearch and want to migrate to dutchAddressRangePostcodeSearch, there are several differences you need to consider.

First of all, the output structure is different. A DutchAddressPostcodeRange is returned instead of a Address::PCReeks. All output elements have been renamed, and some rarely used elements have been removed. The differences are documented in the documentation of DutchAddressPostcodeRange.

Secondly, all error handling should be done based on only Error Handling::Error codes. Error specific strings such as ‘postcode::address_get_by_postcode::unknown_address’ are no longer returned.

Finally, house boat and trailer addresses are handled differently. House boat or trailer flags (AB/WW) in combination with house number 0 are no longer supported. House boats and trailer addresses can be validated using their postcode and house number combination like any other address. Separate range indications for house boats and trailers are no longer used. The empty range indication for ‘vacant’ addresses is also no longer applicable.

Parameters

address

Address to validate, in the unique ‘1234AA12’ postcode house number format.

Returns

out	A DutchAddressPostcodeRange structure.

DutchAddressPostcodeRange

A single address range entry. A range specifies a set of house numbers using the fields house_number_from, house_number_to and range_indication. A range relates to a single postcode, but a postcode may contain multiple ranges.

If a function returns a DutchAddressPostcodeRange, it means the given address could be in the returned range. However, the combination of house number and house number addition is not guaranteed to exist. In some cases, not all house numbers between house_number_from and house_number_to exist.

Differences with Address::PCReeks

Although both structures represent an address house number range there are some differences. These differences are listed in Dutch Address::PCReeks field mapping.

DutchAddressPostcodeRange fields

house_number_from

Lowest house number of the postcode range. Between 0 and 99999

house_number_to

Highest house number of the postcode range. Between 0 and 99999

neighborhood_code

Four number neighborhood code (first part of a postcode). Between 1000 and 9999

letter_combination

Two character letter combination (second part of a postcode). Range: ‘AA’-’ZZ’

range_indication

Postcode range type. Possible values:

’0’	range of odd house numbers
’1’	range of even house numbers

street_name

Street name in accordance with municipal administration for “OpenbareRuimte” The street name ‘Postbus’ is returned for a range of PO boxes. In capital and lowercase letters, including punctuation marks. This field is at most 43 characters in length. Longer street names are shortened using a custom algorithm.

street_name_nen

Street name either the ‘naam’ or the ‘verkorteNaam’ in accordance municipal administration for “OpenbareRuimte”. Contains ‘Postbus’ for a range of PO boxes. In capital and lowercase letters, including punctuation marks. This field is at most 24 characters in length.

city

City name in accordance with the municipal administration “Woonplaats” In capitals including punctuation marks. This field is at most 24 characters in length. Longer city names are shortened using a custom algorithm.

municipality

Municipality name in capital letters. This field is at most 24 characters in length. Longer municipality names are shortened using a custom algorithm.

municipality_code

Code given for municipalities as defined by the Ministry of Home Affairs ‘Ministerie van binnenlandse zaken’

cebuco_code

Code given by CeBuCo (Centraal Bureau voor Courantenpubliciteit). Range: ‘0’-’999’

province

Official name of the province, correctly cased and with dashes where applicable.

province_code

Code of the province, a single letter.

PCReeks field mapping

Elements from Address::PCReeks that have been renamed in DutchAddressPostcodeRange

huisnr_van	house_number_from
huisnr_tm	house_number_to
wijkcode	neighborhood_code
lettercombinatie	letter_combination
reeksindicatie	range_indication
straatnaam	street_name
straatnaam_nen	street_name_nen
plaatsnaam	city
gemeentenaam	municipality
gemeentecode	municipality_code
cebucocode	cebuco_code
provinciecode	province
provincienaam	province_code

Elements from Address::PCReeks that are no longer supported

reeksid	generated identifier for the range
straatid	generated identifier for the street
straatnaam_ptt	street name according to the TNT Post conventions
straatnaam_extract	short code derived from ‘straatnaam_ptt’, only used by TNT Post
plaatsid	generated identifier for the city
plaatsnaam_ptt	city according to the TNT Post conventions
plaatsnaam_extract	short code derived from ‘plaatsnaam_ptt’, only used by TNT Post
gemeenteid	generated identifier for the municipality

DutchAddress search methods