2.1.0 2016-10-17 09:13 UTC


Build Status Latest Stable Version

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.


Use Composer to install the package:

composer require geocoder-php/geocoder-extra


Please, read the Geocoder's documentation.


Provider Address? IPv4? IPv6? Reverse? SSL Support? Coverage Terms
OGD Vienna yes no no yes yes Vienna / Austria
Naver yes no no no no South Korea
Geocodio yes no no yes no USA
IpInfo no yes yes no no
Here yes no no yes no
IpGeoBase no yes no yes no Russia
Baidu yes no no yes no China API key required
DataScienceToolkit yes yes no no no USA, Canada yes no no yes yes USA, Canada Optional API key can be provided. $1 CAD for 400 lookups yes no no no no USA Free throttled service. $50 USD for 20000 requests for paid service
OIORest yes no no yes  no Denmark
IGN OpenLS yes no no no no France API key required
what3words yes (3 word address only) no no yes yes Global API key required
ip2c no yes no no no


See Geocoder's CONTRIBUTING file.

Unit Tests

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:


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:

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

You're done!

Contributor Code of Conduct

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.