You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Ed Freyfogle ecc826374d v1.95 2 hours ago
address-formatting@c379c9f197 newwest address-formatting 2 hours ago
git remove tidyall stuff, too complicated, prepare for v1.88 1 month ago
lib/Geo/Address deal with encoded apostrophes, more debugging 2 hours ago
t deal with encoded apostrophes, more debugging 2 hours ago
.gitignore run perltidy 3 months ago
.gitmodules Ahha, submodule URL needs to be explicit 5 years ago
.travis.yml stop trying to test 5.32, travis doesnt seem to have it, though docs would suggest they do 3 months ago
CHANGES v1.95 2 hours ago remove kritika badge, service unfortunately closing 2 months ago Create 5 months ago
dist.ini v1.95 2 hours ago
opencage_logo_300_150.png improved README 1 year ago


A Perl module to take structured address data and format it according to the various global/country rules.

The module runs against a set of templates and test cases from the address-formatting project.

Build status

Build Status CPAN Coverage Status Twitter Follow


For docs please see the Geo::Address::Formatter page on or perldoc Geo::Address::Formatter.


To install into your Perl environment you can use the following command:

$ cpan Geo::Address::Formatter

or (recommended) use cpanm

The address-formatting repository is added as a git submodule. It is versioned, that means it won't automatically update when you run git pull. To point it to a newer version of the configuration run

  1. git submodule init
  2. git submodule update

This will give you the templates as versions with this repository. To fetch the latest templates available use git submodule foreach git pull origin master

See also:

To submit new countries/territories please see the details in the address-formatting repository, this module just processes the templates


# first install Dist::Zilla
dzil clean

# running the test-suite
dzil test --author

# don't forget to increase the version number in dist.ini and CHANGES file
dzil build

# git push, upload to CPAN
dzil release

Copyright OpenCage GmbH [email protected]

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10 or, at your option, any later version of Perl 5 you may have available.

Who is OpenCage GmbH?

We run the OpenCage Geocoder. Learn more about us.

We also run Geomob, a series of regular meetups for location based service creators, where we do our best to highlight geoinnovation. If you like geo stuff, you will probably enjoy the Geomob podcast.