jbelien/geocoder-php-bpost-provider

Geocoder bpost adapter

3.0.0 2026-08-18 20:14 UTC

Requires

• php: ^7.3 || ^8.0
• geocoder-php/common-http: ^4.1
• symfony/http-client: ^7.2
• willdurand/geocoder: ^4.0 || ^5.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.95
• geocoder-php/provider-integration-tests: ^1.0
• php-http/curl-client: ^2.0
• php-http/message: ^1.0
• phpstan/phpstan: ^2.2
• phpunit/phpunit: ^9.5

Provides

• geocoder-php/provider-implementation: 1.0

MIT

Published on Packagist.org on 2026-08-19 17:08 UTC

README

Geocoder PHP is a PHP library which helps you build geo-aware applications by providing a powerful abstraction layer for geocoding manipulations.

This is the "bpost" provider for the Geocoder PHP.

Note

If you want to submit an Issue or create a Pull Request, please do so in the main repository: https://github.com/jbelien/geocoder-php-providers.

Information

• Coverage: Belgium
• Demo: https://www.bpost.be/site/en/webservice-address

Install

composer require jbelien/geocoder-php-bpost-provider

Usage

See Geocoder PHP README file.

use Geocoder\Query\GeocodeQuery;

$httpClient = new \Http\Adapter\Guzzle6\Client();
$provider = new \Geocoder\Provider\bpost\bpost($httpClient);
$geocoder = new \Geocoder\StatefulGeocoder($provider, 'en');

// Query with unstructured address
$result = $geocoder->geocodeQuery(GeocodeQuery::create('5 Place des Palais 1000 Bruxelles'));

// Query with structured address
$query = GeocodeQuery::create('5 Place des Palais 1000 Bruxelles')
    ->withData('streetNumber', '5')
    ->withData('streetName', 'Place des Palais')
    ->withData('postalCode', '1000')
    ->withData('locality', 'Bruxelles');
$results = $geocoder->geocodeQuery($query);