The almost missing Geocoder PHP library!

View the Project on GitHub geocoder-php/GeocoderLaravel

Geocoder for Lavarel 4

This package allows you to use Geocoder in Laravel 4.

Build Status


It can be found on Packagist. The recommended way is through composer.

Edit compose.json and add:

    "require": {
        "toin0u/geocoder-laravel": "@stable"

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

And install dependencies:

$ curl -sS | php
$ php composer.phar install


Find the providers key in app/config/app.php and register the Geocoder Service Provider.

'providers' => array(
    // ...


Find the aliases key in app/config/app.php and register the Geocoder Facade.

'aliases' => array(
    // ...

    'Geocoder' => 'Toin0u\Geocoder\GeocoderFacade',


The service provider creates the following services:

* `geocoder`: the Geocoder instance.
* `geocoder.provider`: the provider used by Geocoder.
* `geocoder.adapter`: the HTTP adapter used to get data from remotes APIs.

By default, the geocoder.provider service uses FreeGeoIP and the geocoder.adapter service uses the cURL adapter. Override these services to use the adapter/provider you want.

See the Geocoder documentation for a list of available adapters and providers.

Example with Facade


// ...
try {
    $geocode = Geocoder::geocode('10 rue Gambetta, Paris, France');
    // ...
} catch (\Exception $e) {
    // Here we will get "The FreeGeoIpProvider does not support Street addresses." ;)
    echo $e->getMessage();


GeocoderLaravel is released under the MIT License. See the bundled LICENSE file for details.