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.
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.
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.
Address to validate, in the unique ‘1234AA12’ postcode house number format.
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.
Lowest house number of the postcode range. Between 0 and 99999
Highest house number of the postcode range. Between 0 and 99999
Four number neighborhood code (first part of a postcode). Between 1000 and 9999
Two character letter combination (second part of a postcode). Range: ‘AA’-’ZZ’
Postcode range type. Possible values:
range of odd house numbers
range of even house numbers
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 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 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 name in capital letters. This field is at most 24 characters in length. Longer municipality names are shortened using a custom algorithm.
Code given for municipalities as defined by the Ministry of Home Affairs ‘Ministerie van binnenlandse zaken’
Code given by CeBuCo (Centraal Bureau voor Courantenpubliciteit). Range: ‘0’-’999’
Official name of the province, correctly cased and with dashes where applicable.