teamzac/geocoder

A simple wrapper about Google's geocoding and direction services

A lightweight wrapper around the Google Maps geocoding service

, _(*1)

Installation

You can install the package via composer:, _(*2)

composer require teamzac/geocoder

Usage

This package uses Laravel's autodiscovery feature, so you do not have to manually add the service provider., _(*3)

You can publish the config file if you'd like, or simply add the following to your .env file:, _(*4)

GOOGLE_MAPS_API_KEY={{YOUR API KEY HERE}}

The TeamZac\Geocoder\Geocoder class can be resolved from the container, or you can use the facade. There are two primary methods on this class:, _(*5)

// get lat/lng from an address
Geocoder::geocode('1600 Pennsvylvania Ave, Washington DC 20500');

// get an address from lat/lng pair
Geocoder::reverseGeocode(38.8976633, -77.036573);

Both methods will return an instance of TeamZac\Geocoder\GeocodeResult, or throw an exception if no results were found., _(*6)

The GeocodeResult class is a simple data transfer object that makes it more convenience to access information about the response., _(*7)

$result = Geocoder::geocode('123 main street anywhere USA');

$result->getState();
$result->getLocality();
$result->getStreetNumber();

For a full list of available methods, just check out the class' implementation., _(*8)

Testing

bash composer test, _(*9)

You'll want to copy the .env.example file as .env.testing.php and add your Google Maps API key to enable testing., _(*10)

Changelog

Please see CHANGELOG for more information what has changed recently., _(*11)

Contributing

Please see CONTRIBUTING for details., _(*12)

Security

If you discover any security related issues, please email chad@zactax.com instead of using the issue tracker., _(*13)

Credits

• Laravel Package Boilerplate