phaza/laravel-norwegian-zip-codes

Laravel models for Norwegian zip codes, municipalities and counties. Includes an artisan command to update data from the official authority.

This package was sponsored by tjenestetorget.no / [TFinans.no][2]

What?

This package contains models, migrations and commands to automatically setup and update the administrative hierarchy of zip codes, municipalities and counties in Norway., _(*1)

How

Install the package, _(*2)

composer require "phaza/laravel-norwegian-zip-codes"

Add service provider
Add NorwegianZipCodes\Providers\NorwegianZipCodesServiceProvider in config/app.php to the 'providers' array, _(*3)

Copy migrations to your migrations folder, _(*4)

php artisan vendor:publish --provider="NorwegianZipCodes\Providers\NorwegianZipCodesServiceProvider"

Run migrations, _(*5)

php artisan migrate

Seed the database, _(*6)

php artisan db:seed --class="NorwegianZipCodeSeeds"

Populate the database, _(*7)

php artisan zip_codes:update

Start using the models, _(*8)

    $zip_code     = \NorwegianZipCodes\Models\ZipCode::find('7340');
    $municipality = $zip_code->municipality;
    $county       = $municipality->county

ER diagram

, _(*9)

Note

All IDs for counties, municipalities and zip_codes are strings. This is because officially the IDs are zero padded, fixed size. (4 for zip codes and municipalities, 2 for counties), _(*10)