geocoder-php/nominatim-provider

Geocoder Nominatim adapter

5.7.0 2023-03-01 10:18 UTC

Requires

• php: ^7.4 || ^8.0
• geocoder-php/common-http: ^4.1
• willdurand/geocoder: ^4.0

Requires (Dev)

• geocoder-php/provider-integration-tests: ^1.0
• php-http/curl-client: ^2.2
• php-http/message: ^1.0
• phpunit/phpunit: ^9.5

Provides

• geocoder-php/provider-implementation: 1.0

MIT

• William Durand

README

This is the Nominatim provider from the PHP Geocoder. This is a READ ONLY repository. See the main repo for information and documentation.

All usage of the Nominatim provider using nominatim.openstreetmap.org must follow the Nominatim Usage Policy !

Install

composer require geocoder-php/nominatim-provider

Usage

If you want to use the "default" Nominatim instance (https://nominatim.openstreetmap.org/) :

$provider = \Geocoder\Provider\Nominatim\Nominatim::withOpenStreetMapServer($httpClient, $userAgent);

If you want to specify yourself the server that will be used :

$provider = new \Geocoder\Provider\Nominatim($httpClient, 'https://nominatim.openstreetmap.org', $userAgent);

Contribute

Contributions are very welcome! Send a pull request to the main repository or report any issues you find on the issue tracker.