chabter/laravel-dutch-postalcode-lookup

Laravel wrapper to perform a Dutch postal code (postcode) lookup using the publicly available PDOK Locatieserver v3.

2.0.1 2023-12-20 16:07 UTC

Requires

• php: ^7.3|^8.0
• guzzlehttp/guzzle: ^7.8.1
• php-http/message: ^1.11
• swisnl/geocoder-php-nationaal-georegister-provider: ^1.6.0

Requires (Dev)

• orchestra/testbench: ^6.12.1
• phpunit/phpunit: ^9.3.3

MIT

• Martijn van de Wetering

README

This package is a Laravel wrapper of Nationaal Georegister provider for Geocoder PHP, which can be used to lookup a postal code to return the corresponding street and city.

The publicly available PDOK Locatieserver v3 (Dutch) is utilized to provide the necessary geodata.

Installation

Use composer to install this package:

$ composer require chabter/laravel-dutch-postalcode-lookup

Usage

Perform a lookup by postal code:

PostalCodeLookupService::lookup('1012JS');

Or perform a lookup by a postal code and house number combination:

PostalCodeLookupService::lookup('1012JS', 1);

The lookup method also supports using house number extensions as follows:

PostalCodeLookupService::lookup('1012JS', '5B');

Response

The lookup method returns a Chabter\PostalCodeLookup\Models\Address model on success, for example:

$address->getPostalCode() => '1012JS';
$address->getHouseNumber() => 1; // or string including housenumber extension
$address->getStreet() => 'Dam';
$address->getCity() => 'Amsterdam';

Testing

Run the tests with:

$ composer test

Support

Version 1.x will also work with Laravel 8 if Guzzle 6 is available (^6.5|7.0 in composer.json).

Postcardware

This package is completely free to use. If it makes it to your production environment we would highly appreciate you sending us a postcard from your hometown! 👏🏼

Our address is: Chabter, Kanaalstraat 12B, 5347KM Oss, Netherlands.

License

The MIT License (MIT). Please see License File for more information.