, (*1)
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., (*2)
Installation
Use Composer to install the package:, (*3)
composer require geocoder-php/geocoder-extra
Usage
Please, read the Geocoder's documentation., (*4)
Providers
| 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 |
| GeoCoder.ca |
yes |
no |
no |
yes |
yes |
USA, Canada |
Optional API key can be provided. $1 CAD for 400 lookups |
| GeoCoder.us |
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 |
| |
Contributing
See Geocoder's
CONTRIBUTING
file., (*5)
Unit Tests
To run unit tests, you'll need cURL and a set of dependencies you can install
using Composer:, (*6)
composer install --dev
Once installed, run the following command:, (*7)
phpunit
You'll obtain some skipped unit tests due to the need of API keys., (*8)
Rename the phpunit.xml.dist file to phpunit.xml, then uncomment the
following lines and add your own API keys:, (*9)
xml
<php>
<!-- <server name="BAIDU_API_KEY" value="YOUR_API_KEY" /> -->
<!-- <server name="IGN_WEB_API_KEY" value="YOUR_API_KEY" /> -->
</php>, (*10)
You're done!, (*11)
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., (*12)
License
geocoder-extra is released under the MIT License. See the bundled LICENSE file
for details., (*13)