Support Peruvian addresses

Problem/Motivation

Currently the information provided in the addressfield field is not localized to Peruvian addresses.

The current fields shown on the address form for Peru (country == 'PE') are: Address 1 (thoroughfare), Address 2 (premise), City (locality) and Postal Code (postal_code).

In Peru, the usual format is the following:

For Lima:

Jr. Mariategui 123 Interior 301A (thoroughfare premise)
Los Olivos (locality)
Lima 39 (postal code)

Outside of Lima:

Jr. Huascar 123 Interior 501A (thoroughfare premise)
Acobamba, Tarma (locality, sub_administrative_area)
Junín (administrative_area)

On Postal codes in Peru

Peru has official national postal codes since 2011, but it is not really common yet and it does not respect department/province/district original political division, so some districts are now split in different postal codes or join with others.

The previous way only has postal codes for Lima department Lima province districts and Callao department Callao province districts, so it does not work for the general case.

Actually I walked to a postal service office today to ask about the right way to write addresses, and they mention that the new postal codes are not really active yet. I would say that will take at least some more years to be adopted. Notice also that most people (the ones we want to use the form) does not even know that a new postal code exists.

Proposed resolution

It makes sense to use outside of Lima format, which would contain the following information:

• Address 1, Street name and number (thoroughfare, required)
• Address 2, internal location (premise, optional)
• Department (administrative_area, required)
• Province (sub_administrative_area, required)
• District (locality, required)

With that information we can map any location in Peru.

Let's use peruvian information from ISO_3166-2 for departments (administrative_area) as the stored.

From what I have seen on other similar issues, the module only wants to know about countries administrative areas. Any other more specific information does not live here, and instead on other modules (i.e. I see addressfield_example defining the details for Switzerland).
So, I guess the best idea would be to create a Peruvian specific module project with that information (FTR, I will use INEI's ubigeo for province and district codes).

Remaining tasks

(reviews needed, tests to be written or run, documentation to be written, etc.)

• Some maintainer review the patch

Done:

• hide postal code
• set administrative division as postal address
• changes label names as proposed
• includes information about administrative areas in Peru
• re-arrange fields to make sense, proposed order as the list in the last section

User interface changes

The user will see a localized version of the addressfield form for Peruvian addresses instead of the generic form.

API changes

None.

Related Issues

#1829900: [meta] Address Field 2.x needs pluggable administrative areas and an actual API, related in the sense that this is n issue about country specific information, but I think we can do enough with current API to support Peruvian addresses using a minor patch(this issue) and a Peruvian specific module.