2017 © Pedro Peláez
 

library address-splitter

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

image

viison/address-splitter

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

  • Wednesday, April 11, 2018
  • by viison
  • Repository
  • 13 Watchers
  • 32 Stars
  • 67,695 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 6 Forks
  • 5 Open issues
  • 12 Versions
  • 18 % Grown

The README.md

AddressSplitting

Packagist Build Status Software License, (*1)

Tries to split an address line into street name, house number and other additional information like building, apartment information etc., (*2)

Installation

This project can be installed via Composer:, (*3)

``` bash $ composer require viison/address-splitter, (*4)


## Usage
The AddressSplittingService only contains one static function `splitAddress` that performs the address splitting.
The function expects one parameter, which is the address line. The function returns an associative array with the
keys `additionToAddress1`, `streetName`, `houseNumber` and `additionToAddress2`. `additionToAddress1` and `additionToAddress2`
contain information given in front of or after the street name & house number, respectively.

## Example
You can use the address splitting service as follows:

```php
var_dump(\VIISON\AddressSplitter\AddressSplitter::splitAddress('Pallaswiesenstr. 57B App. 235'));

The output of this command will be:, (*5)

array(4) {
    ["additionToAddress1"]=>
    string(0) ""
    ["streetName"]=>
    string(16) "Pallaswiesenstr."
    ["houseNumber"]=>
    string(2) "57B"
    ["houseNumberParts"]=> array(2) {
        ["base"]=>
        string(2) "57"
        ["extension"]=>
        string(1) "B"    
    }
    ["additionToAddress2"]=>
    string(8) "App. 235"
}

Supported Address Formats

We try to support all address formats used world-wide. E.g., the address splitter will work no matter if the house number is given in front of or after the street name., (*6)

Here is a number of examples of addresses and how their splitted representation looks like:, (*7)

Address line additionToAddress1 streetName houseNumber base extension additionToAddress2
56, route de Genève route de Genève 56 56
Piazza dell'Indipendenza 14 Piazza dell'Indipendenza 14 14
Neuhof 13/15 Neuhof 13/15 13 15
574 E 10th Street E 10th Street 574 574
1101 Madison St # 600 Madison St 1101 1101 # 600
3940 Radio Road, Unit 110 Radio Road 3940 3940 Unit 110
D 6, 2 D 6 2 2
13 2ème Avenue 2ème Avenue 13 13
Apenrader Str. 16 / Whg. 3 Apenrader Str. 16 16 Whg. 3
Pallaswiesenstr. 57 App. 235 Pallaswiesenstr. 57 57 App. 235
Kirchengasse 7, 1. Stock Zi.Nr. 4 Kirchengasse 7 7 1. Stock Zi.Nr. 4
Wiesentcenter, Bayreuther Str. 108, 2. Stock Wiesentcenter Bayreuther Str. 108 108 2. Stock
244W 300N #101 W 300N 244 244 #101
Corso XXII Marzo 69 Corso XXII Marzo 69 69
Frauenplatz 14 A Frauenplatz 14 A 14 A
Mannerheimintie 13A2 Mannerheimintie 13A2 13 A2
Kerkstraat 13-HS Kerkstraat 13-HS 13 HS
Poststr. 15-WG2 Poststr. 15-WG2 15 WG2
Hollandweg1A Hollandweg 1A 1 A
Poststr. 2 1/2 Poststr. 2 1/2 2 1/2
Breitenstr. 13/15/8/6 Breitenstr. 13/15/8/6 13 13/15/8/6
Österreicher Weg 12A/8/6 Österreicher Weg 12A/8/6 12 A/8/6
Schegargasse 13-15/8/6 Schegargasse 13-15/8/6 13 15/8/6

Unit Tests

The examples above and even more exemplary address lines are part of our unit tests. The unit tests can be run on the following site: https://regex101.com/r/vO5fY7/5, (*8)

You can also run the tests via PHPUnit from the command line:, (*9)

$ phpunit

If you don't have PHPUnit installed globally, run composer install first., (*10)

Further Information

The need for this functionality came up when we noticed that Shopware 5 does not contain individual fields for the street name and the house number anymore. Nevertheless, we needed to have these separated for our DHL Adapter, because the DHL API expects them to be passed individually., (*11)

More background information on how this implementation came together can be found in our blog post., (*12)

Adresstrennung

Dieses Projekt ermöglicht es, eine Adresszeile in Straßennamen und Hausnummer sowie weitere Angaben wie z.B. Gebäude- oder Appartmentinformationen zu trennen. Unterstützt werden eine Vielzahl an Adressformaten, wie sie weltweit verwendet werden. So ist es z.B. unerheblich, ob die Hausnummer auf die Straße folgt oder ihr voran steht., (*13)

License

viison/address-splitter is licensed under the MIT license. See the LICENSE file for more details., (*14)

The Versions

11/04 2018

dev-master

9999999-dev

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

The Development Requires

by VIISON GmbH

10/04 2018

dev-cjuner/another-tricky-address-format

dev-cjuner/another-tricky-address-format

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

The Development Requires

by VIISON GmbH

09/04 2018

dev-windaishi/another-tricky-address-format

dev-windaishi/another-tricky-address-format

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

The Development Requires

by VIISON GmbH

05/03 2018

0.3.2

0.3.2.0

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

The Development Requires

by VIISON GmbH

01/03 2018

dev-windaishi/improve-support-of-austrian-addresses

dev-windaishi/improve-support-of-austrian-addresses

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

The Development Requires

by VIISON GmbH

27/12 2017

0.3.1

0.3.1.0

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

The Development Requires

by VIISON GmbH

22/08 2017

0.3.0

0.3.0.0

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

The Development Requires

by VIISON GmbH

18/05 2017

0.2.3

0.2.3.0

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

  Sources   Download

MIT

The Development Requires

by VIISON GmbH

15/04 2016

0.2.2

0.2.2.0

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

  Sources   Download

MIT

by VIISON GmbH

08/03 2016

0.2.1

0.2.1.0

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

  Sources   Download

MIT

by VIISON GmbH

27/10 2015

0.2.0

0.2.0.0

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

  Sources   Download

MIT

by VIISON GmbH

23/04 2015

0.1.0

0.1.0.0

Tries to split an address line into street name, house number and other additional information like building, apartment information etc.

  Sources   Download

MIT

by VIISON GmbH