wubs/postcode-api

Communicates with the postcodeapi.nu api

Laravel Postcode API

This is a simple laravel package to use the dutch postcode api., _(*1)

Installation

To install this library into your project simply do the following in your project root:, _(*2)

composer require wubs/zip:1.1.*

Laravel specific

If you use Laravel, add 'Wubs\Zip\ZipServiceProvider', to app/config.php in the providers array and add 'Zip' => 'Wubs\Zip\Facades\Zip', to the aliases array, also in app/config.php., _(*3)

Usage

You can use the facade like this:, _(*4)

<?php
Zip::address("1234AA", 11);

Or get it from the IoC container like so:, _(*5)

<?php
$api = $app->make('\Wubs\Zip\ZipApi')

Or inject it into a constructor, _(*6)

<?php namespace App\Http\Controllers;

use Wubs\Zip\ZipApi;

class ZipController extends Controller
{
   private $api;

    public function __construct(ZipApi $api)
    {
        $this->api = $api;

    }
}

Publish the configuration by running:, _(*7)

php artisan vendor:publish

Afterwards the configuration will be located in config/zip.php, _(*8)

I highly recommend using the .env file., _(*9)

Non laravel usage

The package is also usable without Laravel. See the code below., _(*10)

<?php
require 'vendor/autoload.php'

use Wubs\Zip\ZipApi;

$zipApi = new ZipApi("API_KEY");
$address = $postcodeApi->address("1234AA", 11);