Webservices.nl Manual 31-10-2024 |
dutchAddressRangePostcodeSearchDetermine 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::addressReeksPostcodeSearchThis 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
Returns
DutchAddressPostcodeRangeA 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::PCReeksAlthough both structures represent an address house number range there are some differences. These differences are listed in Dutch Address::PCReeks field mapping. DutchAddressPostcodeRange fields
PCReeks field mappingElements from Address::PCReeks that have been renamed in DutchAddressPostcodeRange
Elements from Address::PCReeks that are no longer supported
|