Unison:Global Address Verification: Difference between revisions
No edit summary |
No edit summary |
||
Line 25: | Line 25: | ||
<h3 class="productfield">Address Line 2 | <h3 class="productfield">Address Line 2 - Address Line 4</h3> | ||
:This is optional. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs. | |||
: | |||
Line 64: | Line 56: | ||
<h3 class="productfield">Address | <h3 class="productfield">Address Line 5 - Address Line 8</h3> | ||
:This is optional. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs. | |||
: | |||
Line 93: | Line 73: | ||
<h3 class="productfield">Double Dependent Locality</h3> | <h3 class="productfield">Double Dependent Locality</h3> | ||
:The smallest population center data element. This depends on the Locality and | :The smallest population center data element. This depends on the Locality and Dependent Locality fields. | ||
Line 105: | Line 85: | ||
:The smallest geographic data element. | :The smallest geographic data element. | ||
:'''US Term:''' County | :'''US Term:''' County. | ||
Line 127: | Line 107: | ||
<h3 class="productfield">Zip/Postal Code</h3> | <h3 class="productfield">Zip/Postal Code</h3> | ||
:The | :The postal code. | ||
:'''US Term:''' ZIP Code. | |||
<h3 class="productfield">Country</h3> | <h3 class="productfield">Country</h3> | ||
:The | :The country name. | ||
<h3 class="productfield">Latitude</h3> | <h3 class="productfield">Latitude</h3> | ||
:The latitude of the | :The latitude of the address. | ||
<h3 class="productfield">Longitude</h3> | <h3 class="productfield">Longitude</h3> | ||
:The longitude of the | :The longitude of the address. | ||
<h3 class="productfield">Dependent Locality</h3> | <h3 class="productfield">Dependent Locality</h3> | ||
: | :A dependent locality is a logical area unit that is smaller than a locality but larger than a double dependent locality or thoroughfare. It can often be associated with a neighborhood or sector. Great Britain is an example of a country that uses double dependent locality. In the United States, this would correspond to Urbanization, which is used only in Puerto Rico. | ||
:'''US Term:''' Urbanization | :'''US Term:''' Urbanization. | ||
<h3 class="productfield">Locality</h3> | <h3 class="productfield">Locality</h3> | ||
:The | :The most common geographic area and used by virtually all countries. This is usually the value that is written on a mailing label and referred to by terms like City, Town, Postal Town, etc. | ||
:'''US Term:''' City | :'''US Term:''' City | ||
Line 155: | Line 137: | ||
<h3 class="productfield">Administrative Area/State</h3> | <h3 class="productfield">Administrative Area/State</h3> | ||
: | :A common geographic area unit for larger countries. | ||
:'''US Term:''' State | :'''US Term:''' State | ||
Line 192: | Line 174: | ||
<h3 class="productfield">Result Codes</h3> | <h3 class="productfield">Result Codes</h3> | ||
:Returned result codes for the address. | :Returned result codes for the address. | ||
:For a list of result codes returned by Unison, see [[Result Code Details#Unison by Melissa|Unison Result Codes]]. | |||
Revision as of 22:46, 8 November 2022
The Unison by Melissa Global Address Cleansing Task cleanses global contact data.
Input Fields
This section displays the possible inputs for the Global Address Cleansing Task. An address and Country are required.
Organization/Company
- The company or organization.
Address Line 1
- The first address line. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.
Address Line 2 - Address Line 4
- This is optional. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.
Sub-Premises/Suite
- The sub-premises or suite number.
Locality/City
- The locality name.
- US Term: City
- Canada Term: Municipality
Administrative Area/State
- The administrative area, state or province name.
Postal Code/Zip
- The Zip Code or Postal Code, depending on the country.
Country
- The country code. If this is not input, the country will default to the United States.
More Input Fields
Address Line 5 - Address Line 8
- This is optional. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.
Country of Origin
- This is used to determine whether or not to include the country name as the last line in Formatted Address.
- The destination country will be appended to the end of the formatted address when:
- Valid and different from the destination country.
- The destination country will not be appended to the end of the formatted address when:
- Blank or
- Invalid or
- Same as the destination country
Double Dependent Locality
- The smallest population center data element. This depends on the Locality and Dependent Locality fields.
Dependent Locality/Urbanization
- The smaller population center data element. This depends on the Locality element.
- US Term: Urbanization: In terms of US Addresses, this element applies only to Puerto Rican addresses. It is used to break ties when a ZIP Code™ is linked to multiple instances of the same address.
Sub Administrative Area/County
- The smallest geographic data element.
- US Term: County.
Sub National Area
- The administrative region within a country on an arbitrary level below that of the sovereign state.
Output Fields
This section displays the possible outputs for the Address Service. Select the on/off toggle to enable/disable the output of a field.
Organization
- The company or organization.
Address Line 1 - Address Line 8
- These will be the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
Zip/Postal Code
- The postal code.
- US Term: ZIP Code.
Country
- The country name.
Latitude
- The latitude of the address.
Longitude
- The longitude of the address.
Dependent Locality
- A dependent locality is a logical area unit that is smaller than a locality but larger than a double dependent locality or thoroughfare. It can often be associated with a neighborhood or sector. Great Britain is an example of a country that uses double dependent locality. In the United States, this would correspond to Urbanization, which is used only in Puerto Rico.
- US Term: Urbanization.
Locality
- The most common geographic area and used by virtually all countries. This is usually the value that is written on a mailing label and referred to by terms like City, Town, Postal Town, etc.
- US Term: City
Administrative Area/State
- A common geographic area unit for larger countries.
- US Term: State
Delivery Line
Locality Line
Melissa Address Key (MAK)
- (MAK) A unique key assigned to an address record.
Melissa Address Key Base
- A unique key assigned to the base address of a complex with apartments or suites.
Address Type Code
- Returns a one-character code for the type of address coded. This element works only for US, Canadian, and Great Britain addresses.
- See Unison by Melissa Result Codes for a full list of result codes.
Formatted Address
- Returns the address in the correct format for mailing from the country specified in the Country Of Origin input. This includes the Organization as the first line, one or more lines in the origin country’s format, and the destination country (if required).
UPRN
- Great Britain Only. Returns the Unique Property Reference Number created and maintained by Ordnance Survey.
Result Codes
- Returned result codes for the address.
- For a list of result codes returned by Unison, see Unison Result Codes.
Additional Address Fields
Adds fields for parsed data from the address.
ISO 2 Country Code
- The 2 letter ISO 3166 country code value.
- For example:
Country Code United States US Canada CA Philippines PH
ISO 3 Country Code
- The 3 letter ISO 3166 country code value.
- For example:
Country Code United States USA Canada CAN Philippines PHL
ISO Country Number
- The ISO 3166 country number value.
- For example:
Country Code United States 840 Canada 124 Philippines 608
Formal Country Name
Country Code
Parsed Dependent Thoroughfare Fields
Adds fields relating to the Dependent Thoroughfare from the address.
Dependent Thoroughfare
- The parsed Dependent Thoroughfare. The dependent thoroughfare is a second thoroughfare that is required to narrow down the final address. This is rarely used.
Dependent Thoroughfare Pre Direction
- The parsed Dependent Thoroughfare Pre Direction. This value is a part of the DependentThoroughfare field.
Dependent Thoroughfare Post Direction
- The parsed Dependent Thoroughfare Post Direction. This value is a part of the DependentThoroughfare field.
Dependent Thoroughfare Leading Type
- The parsed Dependent Thoroughfare Leading Type. This value is a part of the DependentThoroughfare field.
Dependent Thoroughfare Name
- The parsed Dependent Thoroughfare Name. This value is a part of the DependentThoroughfare field.
Dependent Thoroughfare Trailing Type
- The parsed Dependent Thoroughfare Trailing Type. This value is a part of the DependentThoroughfare field.
Dependent Thoroughfare Type Attached
Parsed Regional Fields
Adds additional fields relating to the region from the address.
Double Dependent Locality
- A logical area unit that is smaller than a dependent locality but bigger than a thoroughfare. This field is very rarely used. Great Britain is an example of a country that uses double dependent locality.
Sub Administrative Area
- A logical area that that is smaller than the administrative area but larger than a locality. While many countries can have a sub-administrative area value, it is very rarely used as part of an official address.
Sub National Area
- A logical area unit that is larger than an administrative area but smaller than the country itself. It is extremely rarely used.
Parsed Postal Facility Fields
Adds additional fields relating to the postal facility.
Post Box
- The parsed Post Box.
Post Office Location
- If available, this is the value that is associated to the location of the post office in relation to the address. This value may or may not be used in the official mailing address for the country in question. Currently, these are the countries we will return the data for: Serbia and Slovakia.
Country Description Serbia The Post Office Location field contains the old 5 digit postal number and name. The postal code field will contain the new 6 digit PAK number. Slovakia The Post Office Location field returns the name of the post office location if it is not the same as the delivery address locality.
Parsed Thoroughfare Fields
Adds fields relating to the Thoroughfare from the address.
Premises/Street Name
Premises Number/Street Number
- The parsed premises number.
- US Term: House Number
Premises Type
- The parsed premises type.
Thoroughfare
- A part of the address lines containing all the sub-elements of the thoroughfare like trailing type, thoroughfare name, pre direction, post direction, etc.
- US Term: Street
Thoroughfare Name
- The parsed thoroughfare name. This is part of the thoroughfare field.
Thoroughfare Pre Direction
- Pre Directions are directionals at the beginning of the thoroughfare (i.e., N, S, E, W, NE, SW, etc.). This is part of the thoroughfare field.
Thoroughfare Post Direction
- Post Directions are directionals at the end of the thoroughfare (i.e., N, S, E, W, NE, SW, etc.). This is part of the thoroughfare field.
Thoroughfare Leading Type
- Leading Types are thoroughfare types at the beginning of the thoroughfare (i.e., "Rue", etc.). This is part of the thoroughfare field.
- This term is not used in the US.
Thoroughfare Trailing Type
- Trailing Types are thoroughfare types at the end of the thoroughfare (i.e., "St.", "Rd.", "Ave.", etc.). This is part of the thoroughfare field.
Thoroughfare Type Attached
Parsed Subpremises Fields
Adds fields relating to the sub premises from the address.
Building
Sub Building
Sub Building Number
Sub Building Type
Sub Premises/Suite
Sub Premises Type
Sub Premises Level
Sub Premises Level Number
Sub Premises Level Type
Sub Premises Number
Extra Information Fields
Adds miscellaneous fields to the output record.
Remnants
Timezone
UTC
DST
Address Key
Delivery Indicator
Census Key
Delivery Point Suffix
Delivery Line 1
Delivery Line 2
Delivery Line 3
Delivery Line 4
Delivery Line 5
Delivery Line 6
Delivery Line 7