shivella/postcode-bundle

Symfony Postcode bundle

Apiwise Postcode Bundle

This bundle can be useed to fetch Address details from zipcode with number. An account at Apiwise is required. For more information please take a look at: https://www.postcodeapi.nu, _(*1)

, _(*2)

Installation

Installation is a quick 4 step process:, _(*3)

1. Download postcode-bundle using composer
2. Enable the Bundle in AppKernel.php
3. Configure Apiwise credentials
4. Add routes

Step 1: Download postcode-bundle using composer

Add UsoftPostcodeBundle by running the command:, _(*4)

``` bash $ composer require shivella/postcode-bundle, <sub>(*5)</sub>

### Step 2: Enable the Bundle in AppKernel.php


``` php
<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Usoft\PostcodeBundle\UsoftPostcodeBundle(),
    );
}

Step 3: Configure Apiwise credentials

# app/config/config.yml

# Apiwise Postcode API
usoft_postcode:
    apiwise:
        key: secret_api_wise_key

Step 4. Add routes

# app/config/routing.yml

postcode:
    resource: "@UsoftPostcodeBundle/Resources/config/routing.yml"
    prefix:   /

Usage Services

``` php $address = $this->get('usoft.postcode.client')->getAddress('1012JS', 1);, <sub>(*6)</sub>

$address->getStreet(); // Dam $address->getCity(); // Amsterdam $address->getMunicipality(); // Amsterdam $address->getProvince(); // Noord-Holland $address->getNumber(); // 1 $address->getZipcode(); // 1012JS $address->getGeoLocation(); // array('latitude' => 52.3732926, 'longitude' => 4.8937176) ```, <sub>(*7)</sub>

Usage from API

Or try the API response:, <sub>(*8)</sub>

http://127.0.0.1:8000/api/postcode?postcode=2011WD&nummer=2, <sub>(*9)</sub>