szhorvath/laravel-getaddress

Laravel Package for getaddress.io

laravel-getaddress

![Software License][ico-license] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads], _(*1)

Laravel-getaddress provides a wrapper around getaddress.io for laravel 5.4 and up. This package is based on PeteLawrence/getaddress PHP library., _(*2)

Installation in Laravel 5.4

You can pull in the package via composer:, _(*3)

$ composer require szhorvath/laravel-getaddress

You need to add Szhorvath\GetAddress\GetAddressServiceProvider to your config/app.php providers array:, _(*4)

Szhorvath\GetAddress\GetAddressServiceProvider::class,

Add the following environmental variable to your .env file, _(*5)

GETADDRESSIO_API_KEY=your-api-key

You must publish the config file:, _(*6)

$ php artisan vendor:publish --provider="Szhorvath\GetAddress\GetAddressServiceProvider"

Installation in Laravel 5.5 and up

You can pull in the package via composer:, _(*7)

$ composer require szhorvath/laravel-getaddress

The package will automatically register itself., _(*8)

Add the following environmental variable to your .env file, _(*9)

GETADDRESSIO_API_KEY=your-api-key

You must publish the config file:, _(*10)

$ php artisan vendor:publish --provider="Szhorvath\GetAddress\GetAddressServiceProvider"

Usage

In a controller you can use the Facade. The GetAddress always returns an array, _(*11)

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Szhorvath\GetAddress\Facades\GetAddress;

class AddressController extends Controller
{
    public function lookup()
    {
        $result = GetAddress::lookup('S20 8JH');

        $longitude = $result->getLongitude();
        $latitude = $result->getLatitude();
        $addressList = $result->getAddresses();

        foreach ($addressList as $key => $address) {
            $line1 = $address->getLine1();
            $line2 = $address->getLine2();
            $line3 = $address->getLine3();
            $line4 = $address->getLine4();
            $town  = $address->getTown();
            $postalTown = $address->getPostalTown();
            $normalisedTown = $address->getNormalisedTown();
            $county = $address->getCounty();
            #Full address as comma separated string
            $csv = $address->toCsv();
        }

        #Or for a specific address you can pass the house number or name as second parameter
        $result = GetAddress::lookup('S20 8JH', 5);
        if ($address = $result->getAddress()) {
            $town  = $address->getTown();
        };
    }
}

Change log

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

Testing

$ composer test

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details., _(*13)

Security

If you discover any security related issues, please email z.sandor.horvath@gmail.com instead of using the issue tracker., _(*14)

Credits

• Sandor Horvath
• All Contributors

License

The MIT License (MIT). Please see License File for more information., _(*15)