Geocoder Service Provider for Laravel
If you still use Laravel 4, please check out the
Version 1.0.0 is a backwards-compatibility-breaking update. Please review this documentation, especially the Usage section before installing.
- Install the package via composer:
composer require toin0u/geocoder-laravel
Once 1.0.0 is stable, we will update this command to reflect that. In the interest of getting it out and into your hands, a temporary RC build is best.
- Find the
providersarray key in
config/app.phpand register the Geocoder Service Provider:
// 'providers' => [ Geocoder\Laravel\Providers\GeocoderService::class, // ];
If you are upgrading from a pre-1.x version of this package, please keep the following things in mind:
Update your composer.json file as follows:
config/geocoder.phpconfiguration file. (If you need to customize it, follow the configuration instructions below.)
Remove any Geocoder alias in the aliases section of your
config/app.php. (This package auto-registers the aliases.)
Update the service provider entry in your
If you are using the facade in your code, you have two options:
Replace the facades
Geocoder::(and remove the corresponding
usestatements to the following:
use use Geocoder\Laravel\Facades\Geocoder;
Update your query statements to use
->get()(to retrieve a collection of GeoCoder objects) or
->all()(to retrieve an array of arrays), then iterate to process each result.
Pay special attention to the language and region values if you are using them. For example, the GoogleMaps provider uses TLDs for region values, and the following for language values: https://developers.google.com/maps/faq#languagesupport.
Further, a special note on the GoogleMaps provider: if you are using an API key, you must also use set HTTPS to true. (Best is to leave it true always, unless there is a special requirement not to.)
See the Geocoder documentation for a list of available adapters and providers.
By default, the configuration specifies a Chain Provider as the first provider, containing GoogleMaps and FreeGeoIp providers. The first to return a result will be returned. After the Chain Provider, we have added the BingMaps provider for use in specific situations (providers contained in the Chain provider will be run by default, providers not in the Chain provider need to be called explicitly). The second GoogleMaps Provider outside of the Chain Provider is there just to illustrate this point (and is used by the PHPUnit tests).
return [ 'providers' => [ Chain::class => [ GoogleMaps::class => [ 'en', 'us', true, env('GOOGLE_MAPS_API_KEY'), ], FreeGeoIp::class => , ], BingMaps::class => [ 'en-US', env('BING_MAPS_API_KEY'), ], GoogleMaps::class => [ 'en', 'us', true, env('GOOGLE_MAPS_API_KEY'), ], ], 'adapter' => CurlHttpAdapter::class, ];
If you would like to make changes to the default configuration, publish and edit the configuration file:
php artisan vendor:publish --provider="Geocoder\Laravel\GeocoderServiceProvider" --tag="config"
The service provider initializes the
geocoder service, accessible via the
Geocoder::... or the application helper
app('geocoder')->geocode('Los Angeles, CA')->get();
app('geocoder')->geocode('Los Angeles, CA')->all();
app('geocoder')->geocode('Los Angeles, CA')->dump('kml');
If you are experiencing difficulties, please please open an issue on GitHub: https://github.com/geocoder-php/GeocoderLaravel/issues.
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.
GeocoderLaravel is released under the MIT License. See the bundled LICENSE file for details.