Google Geocoder API v3 for Laravel

Google Geocoder API for Lavarel 4

This package provides simple facility to make [The Google Geocoding API v3] (https://developers.google.com/maps/documentation/geocoding/) calls with Laravel 4.

Installation

To install edit composer.json and add following line:

"alexpechkarev/google-geocoder": "dev-master"

Run composer update

Configuration

Once installed, register Laravel service provider, in your app/config/app.php:

'providers' => array(
	...
    'Alexpechkarev\GoogleGeocoder\GoogleGeocoderServiceProvider',
)

Publish configuration file:

$ php artisan config:publish alexpechkarev/google-geocoder --path vendor/alexpechkarev/google-geocoder/src/config/

Usage

Before making calls please ensure you obtain API Key to identify your application and add this key in the configuration file. More information on API Key please refer to The Google Geocoding API.

'applicationKey' => 'your-api-key',

Create an array with key=>value pairs specifying address you would like to geocode:

$param = array("address"=>"76 Buckingham Palace Road London SW1W 9TQ");

Use following command to receive Geocoding response in json format, use xml as fist parameter for XML response.

$reponse = Geocoder::geocode('json', $param);

To restrict your results to a specific area use component filter Component Filtering by adding it's filters to parameter array.

$param = array(
                "address"=>"76 Buckingham Palace Road London SW1W 9TQ",
                "componets"=>"country:GB"
            );

Geocoding API supports translation of map coordinates into human-readable address by reverse geocoding using latitude and longitude parameters. For more details refer to Reverse Geocoding To make reverse geocoding request use following:

$param = array("latlng"=>"40.714224,-73.961452");
$reponse = Geocoder::geocode('json', $param);

All requests will return string value. For Response example, Status Codes, Error Messages and Results please refer to [Geocoding Responses] (https://developers.google.com/maps/documentation/geocoding/#GeocodingResponses)

Support

Please open an issue on GitHub

License

Google Geocoder for Laravel 4 is released under the MIT License. See the bundled LICENSE file for details.