This repository hosts Geocoder extra features that do not belong to the core but can be nonetheless interesting to share with other developers. It mostly contains providers.

The recommended way to install this package is through Composer:

{
    "require": {
        "geocoder-php/geocoder-extra": "@stable"
    }
}

Protip: you should browse the geocoder-php/geocoder-extra page to choose a stable version to use, avoid the @stable meta constraint.

Please, read the Geocoder's documentation.

See Geocoder's CONTRIBUTING file.

To run unit tests, you'll need cURL and a set of dependencies you can install using Composer:

composer install --dev

Once installed, run the following command:

phpunit

You'll obtain some skipped unit tests due to the need of API keys.

Rename the phpunit.xml.dist file to phpunit.xml, then uncomment the following lines and add your own API keys:

<php>
    <!-- <server name="BAIDU_API_KEY" value="YOUR_API_KEY" /> -->
    <!-- <server name="IGN_WEB_API_KEY" value="YOUR_API_KEY" /> -->
</php>

You're done!

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

geocoder-extra is released under the MIT License. See the bundled LICENSE file for details.