Address Validator Port Reference

10.2.2
- 10.5.6
- 10.5.4
- 10.5
- 10.4.0
- 10.2.1

Back Next

Locality Preferred Name Ports

Output port that returns the official or formally correct name of a locality in Canada or in the United States.

In almost all addresses, the Locality Preferred Name port returns the same name as the Locality Name port. In a small number of cases, the formal or official locality name is not used by the general public. For example, "North York" is a locality within the area covered by the city of Toronto. If the Address Validator transformation finds an address in the North York locality, it writes "Toronto" to the Locality Name port and writes "North York" to the Locality Preferred Name port.

Locality Preferred Name Usage

Select Locality Preferred Name to write the formally correct version of a locality name to the address record. Use the port to find the locality name when the address uses an alternative name for the locality.

Consider the following guidelines when you use the Locality Preferred Name ports:

If an address contains multiple locality levels, use multiple locality ports. For example, use Locality Preferred Name 1 for the primary or largest locality in the address. Use Locality Preferred Name 2 to identify a town within the locality that Locality Preferred Name 1 identifies.

There are six Locality Preferred Name ports. Most countries use Locality Preferred Name 1 or Locality Preferred Name 2. You may need to select additional locality ports if the locality data is highly complex.

You can use the Locality Preferred Name ports with any other locality data output port.

Port Location

The following table provides the location and default precision of ports Locality Preferred Name 1 through Locality Preferred Name 3:

Port Type	Port Group	Template Model	Precision
Output	Last Line Elements	Basic	100

The following table provides the location and default precision of ports Locality Preferred Name 4 through Locality Preferred Name 6:

Port Type	Port Group	Template Model	Precision
Output	Last Line Elements	Advanced	100

Locality Preferred Name Output Codes

The following example address contains data that the Address Validator transformation can parse to the Locality Preferred Name port:

Ms. Susan Smith
DEF Inc. 
1850 Wilson Ave.
Toronto ON M9M 1A1
CAN

The following table shows the Address Validator transformation port that contains the Locality Preferred Name data in this address:

Port	Data
Contact Complete 1	MS. SUSAN SMITH
Organization Complete 1	DEF INC.
Street Number Complete 1	1850
Street Complete 1	WILSON AVE
Locality Name 1	TORONTO
Locality Preferred Name 1	NORTH YORK
Province Abbreviation 1	ON
Postcode Complete 1	M9M 1A1
Country ISO3 Char	CAN

Rename Saved Search

Table of Contents

Address Validator Port Reference

Address Validator Port Reference

Locality Preferred Name Ports

Locality Preferred Name Ports

Locality Preferred Name Usage

Port Location

Locality Preferred Name Output Codes