Difference between revisions of "Global Address Object:Input Parameters"

From Melissa Data Wiki
Jump to navigation Jump to search
Line 10: Line 10:


==Processing Configuration Parameters==
==Processing Configuration Parameters==
===countryOfOrigin===
<h3 style="background-color:rgb(240,240,240);">countryOfOrigin</h3>
The country of origin (the address being validated is the destination). Used to determine whether the destination country should be added to the formatted address.
:The country of origin (the address being validated is the destination). Used to determine whether the destination country should be added to the formatted address.


===outputPreference===
:{| class="alternate01 sortable"
Determine the script of the output, two possible values "native" and "latin." Native tells the object to return the output in the native script i.e. cyrillic for Russia. Latin transliterates the output to latin characters.
!Option Name !! Parameter !! Description
|-
|'''countryOfOrigin'''
|(Any valid ISO-3166-1 Alpha-2, ISO-3166-1 Alpha-3, or ISO-3166-1 Numeric code)
|
*If blank, invalid, or the same as the destination country, then the destination country is not appended to the end of the formatted address.
*If valid and different from the destination country, then the destination country is appended to the formatted address.
*US or US Territory:
:*If '''''countryOfOrigin''''' and destination country being verified are both US or US Territories then the country will not be appended to '''''formattedAddress'''''.
:*US Territories will have "United States of America" appended if the '''''countryOfOrigin''''' is not a US Territory, but the '''''countryName''''' and ISO codes will be that of the territory.
:*Canada is treated like any other non-US Territory.
|}


===inputFormattedAddressSeparator===
 
This is a string used to delimit line in the FormattedAddress output field. This string can be one or multiple characters.
<h3 style="background-color:rgb(240,240,240);">outputPreference</h3>
:This is the script type used for all applicable fields.
 
:{| class="alternate01 sortable"
!Option Name !! Parameter !! Description
|-
|rowspan="3"|'''outputPreference'''||<code>[Blank]</code>||'''''Default.''''' Returns the same script that is sent in.
|-
|<code>LATIN</code>||Returns in the Latin script.
|-
|<code>NATIVE</code>||Returns in the native script for the designated country.
|}
 
 
<h3 style="background-color:rgb(240,240,240);">inputFormattedAddressSeparator</h3>
:This is a string used to delimit line in the '''''formattedAddress''''' output field. This string can be one or multiple characters.




==Input Address Parameters==
==Input Address Parameters==
===inputOrganization===
<h3 style="background-color:rgb(240,240,240);">inputOrganization</h3>
'''''Business''''' or '''''Company'''''.
:The organization name associated with the address record.
 
<h3 style="background-color:rgb(240,240,240);">inputAddressLine1</h3>
:''Required.''
 
:The input field for the address. 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.
 
 
<h3 style="background-color:rgb(240,240,240);">inputAddressLine2</h3>
:''Optional.''
 
:The input field for the address. 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.
 
 
<h3 style="background-color:rgb(240,240,240);">inputAddressLine3</h3>
:''Optional.''
 
:The input field for the address. 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.
 
 
<h3 style="background-color:rgb(240,240,240);">inputAddressLine4</h3>
:''Optional.''
 
:The input field for the address. 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.
 
 
<h3 style="background-color:rgb(240,240,240);">inputAddressLine5</h3>
:''Optional.''
 
:The input field for the address. 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.
 
 
<h3 style="background-color:rgb(240,240,240);">inputAddressLine6</h3>
:''Optional.''
 
:The input field for the address. 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.
 
 
<h3 style="background-color:rgb(240,240,240);">inputAddressLine7</h3>
:''Optional.''
 
:The input field for the address. 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.
 
 
<h3 style="background-color:rgb(240,240,240);">inputAddressLine8</h3>
:''Optional.''
 
:The input field for the address. 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.
 
 
<h3 style="background-color:rgb(240,240,240);">inputSubPremises</h3>
:''Optional.''
 
:Alphanumeric code identifying an individual location.
 
:'''US Term:''' Suite
 
 
<h3 style="background-color:rgb(240,240,240);">inputDoubleDependentLocality</h3>
:''Optional.''
 
:The smallest population center data element. This depends on the Locality and DependentLocality elements.
 
 
<h3 style="background-color:rgb(240,240,240);">inputDependentLocality</h3>
:''Optional.''
 
: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.
 
 
<h3 style="background-color:rgb(240,240,240);">inputLocality</h3>
:''Required.''
 
:The most common population center data element.
 
:'''US Term:''' City
:'''Canada Term:''' Municipality
 
 
<h3 style="background-color:rgb(240,240,240);">inputSubAdministrativeArea</h3>
:''Optional.''
 
:The smallest geographic data element.
 
:'''US Term:''' County
 
 
<h3 style="background-color:rgb(240,240,240);">inputAdministrativeArea</h3>
:''Required.''
 
:The most common geographic data element.
 
:'''US Term:''' State
:'''Canada Term:''' Province
 


===inputAddressLine1===
<h3 style="background-color:rgb(240,240,240);">inputSubNationalArea</h3>
Address lines should include, at minimum, the delivery address. It can also contain the full address if you do not have the area information (locality, administrative area, postal code) parsed into their individual fields.
:''Optional.''


===inputAddressLine2===
:The administrative region within a country on an arbitrary level below that of the sovereign state.
===inputAddressLine3===
===inputAddressLine4===
===inputAddressLine5===
===inputAddressLine6===
===inputAddressLine7===
===inputAddressLine8===
===inputSubPremises===
'''''Suite'''''. Alphanumeric code identifying an individual location.


===inputDoubleDependentLocality===
Smallest population center data element.


===inputDependentLocality===
<h3 style="background-color:rgb(240,240,240);">inputPostalCode</h3>
'''''Urbanization'''''. Smaller population center data element. Dependent on Locality.
:''Required.''


===inputLocality===
:The complete postal code for a particular delivery point.
'''''City'''''. Most common population center data element.


===inputSubAdministrativeArea===
:'''US Term:''' ZIP
'''''County'''''. Smallest geographic data element.
:'''Canadian Term:''' Postcode


===inputAdministrativeArea===
:If all three elements are provided and the PostalCode is incorrect, it can be corrected from the data on the Locality and AdministrativeArea.
'''''State'''''. Most common geographic data element.


===inputSubNationalArea===
Arbitrary administrative region below that of the sovereign state.


===inputPostalCode===
<h3 style="background-color:rgb(240,240,240);">inputCountry</h3>
'''''Zip (Plus 4).''''' Complete postal code for a particular delivery point. In U.S. plus 4 is not required but will be appended if address is verified.
:''Required.''


===inputCountry===
:The country name, abbreviation, or code.
The country of the address.




[[Category:Global Address Object]]
[[Category:Global Address Object]]
[[Category:Reference]]
[[Category:Reference]]

Revision as of 23:38, 15 September 2017

← Global Address Object Reference

Global Address Object Navigation
Introduction
System Requirements
Setup
Licensing
Interface
Address Handling
Interface Use
Methods
Setup Methods
Input Methods
Processing Methods
Output Methods
Parameters
Input Parameters
Output Parameters
Result Codes
Global Address Object Result Codes
Other Codes



Though they are listed in mixed case, the parameters are not case sensitive.

All of the following inputs can be set using SetInputParamter and can also be output using GetOutputParameter.

Processing Configuration Parameters

countryOfOrigin

The country of origin (the address being validated is the destination). Used to determine whether the destination country should be added to the formatted address.
Option Name Parameter Description
countryOfOrigin (Any valid ISO-3166-1 Alpha-2, ISO-3166-1 Alpha-3, or ISO-3166-1 Numeric code)
  • If blank, invalid, or the same as the destination country, then the destination country is not appended to the end of the formatted address.
  • If valid and different from the destination country, then the destination country is appended to the formatted address.
  • US or US Territory:
  • If countryOfOrigin and destination country being verified are both US or US Territories then the country will not be appended to formattedAddress.
  • US Territories will have "United States of America" appended if the countryOfOrigin is not a US Territory, but the countryName and ISO codes will be that of the territory.
  • Canada is treated like any other non-US Territory.


outputPreference

This is the script type used for all applicable fields.
Option Name Parameter Description
outputPreference [Blank] Default. Returns the same script that is sent in.
LATIN Returns in the Latin script.
NATIVE Returns in the native script for the designated country.


inputFormattedAddressSeparator

This is a string used to delimit line in the formattedAddress output field. This string can be one or multiple characters.


Input Address Parameters

inputOrganization

The organization name associated with the address record.

inputAddressLine1

Required.
The input field for the address. 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.


inputAddressLine2

Optional.
The input field for the address. 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.


inputAddressLine3

Optional.
The input field for the address. 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.


inputAddressLine4

Optional.
The input field for the address. 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.


inputAddressLine5

Optional.
The input field for the address. 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.


inputAddressLine6

Optional.
The input field for the address. 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.


inputAddressLine7

Optional.
The input field for the address. 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.


inputAddressLine8

Optional.
The input field for the address. 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.


inputSubPremises

Optional.
Alphanumeric code identifying an individual location.
US Term: Suite


inputDoubleDependentLocality

Optional.
The smallest population center data element. This depends on the Locality and DependentLocality elements.


inputDependentLocality

Optional.
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.


inputLocality

Required.
The most common population center data element.
US Term: City
Canada Term: Municipality


inputSubAdministrativeArea

Optional.
The smallest geographic data element.
US Term: County


inputAdministrativeArea

Required.
The most common geographic data element.
US Term: State
Canada Term: Province


inputSubNationalArea

Optional.
The administrative region within a country on an arbitrary level below that of the sovereign state.


inputPostalCode

Required.
The complete postal code for a particular delivery point.
US Term: ZIP
Canadian Term: Postcode
If all three elements are provided and the PostalCode is incorrect, it can be corrected from the data on the Locality and AdministrativeArea.


inputCountry

Required.
The country name, abbreviation, or code.