Output Options

Table 1. Validate Address Global Output Options

Option

Description

Maximum number of results returned

This option specifies the maximum number of candidate addresses to return. This field is disabled for batch processing; for all other processing modes the default is 1 and the maximum is 99. If you are using FastCompletion mode, you may want to enter a number greater than 1 to ensure you are provided with multiple options for completing a field.

Return input data with results

Specifies whether to include the input data in the output. If enabled, the output will contain fields that end with .Input containing the corresponding input field. For example, the output field AddressLine1.Input would contain the data specified in the input field AddressLine1.

State/Province

Specifies the format for the StateProvince field. One of the following.

Abbreviation
Return the abbreviation for the state or province. For example, North Carolina would be returned as "NC".
Country standard
Return either the abbreviation or the full name depending on the format used by the country's postal authority. (Default)
Extended
Return the full name of the state or province, not the abbreviation. For example "North Carolina".

Country format

Specifies the language or code to use for the country name returned by Validate Address Global.

  • Chinese
  • Danish
  • Dutch
  • English (default)
  • Finnish
  • French
  • German
  • Greek
  • Hungarian
  • ISO number (returns the ISO number for the country)
  • ISO2 (returns the two-character ISO country code)
  • ISO3 (returns the three-character ISO country code)
  • Italian
  • Japanese
  • Korean
  • Polish
  • Portuguese
  • Russian
  • Sanskrit
  • Spanish
  • Swedish

Script/Alphabet

Specifies the alphabet in which the output should be returned. The alphabet in which the data is returned differs from country to country. For most countries the output will be Latin I regardless of the selected preferred language.

ASCII extended
ASCII characters with expansion of special characters (e.g. Ö = OE)
ASCII simplified
ASCII characters
Database
(default) Latin I or ASCII characters (as per reference database standard)
Latin
Latin I characters
Latin alternate
Latin I characters (alternative transliteration)
Postal admin alternate
Latin I or ASCII characters (local postal administration alternative)
Postal admin preferred
Latin I or ASCII characters (as preferred by local postal administration)

For countries that use an alphabet other than Latin I, the returned alphabet differs from country to country. For more information, see Alphabets for Non-Latin 1 Countries.

Language

Specifies the language in which the output should be returned. The alphabet in which the data is returned differs from country to country, but for most countries the output will be Latin, regardless of the selected preferred language.

Database
Language derived from reference data for each address. Default.
English
English locality and state/province names output, if available.

Format Delimiter

Enables you to use non-standard formatting for multi-line addresses in the output. Acceptable values for this field include the following:
  • CRLF (default)
  • LF
  • CR
  • SEMICOLON ( 2101 MASSACHUSETTS AVE NW ; WASHINGTON DC 20008)
  • COMMA (2101 MASSACHUSETTS AVE NW , WASHINGTON DC 20008 )
  • TAB (2101 MASSACHUSETTS AVE NW WASHINGTON DC 20008 )
  • PIPE (2101 MASSACHUSETTS AVE NW | WASHINGTON DC 20008 )
  • SPACE (2101 MASSACHUSETTS AVE NW  WASHINGTON DC 20008)
Note: The same value must be selected for both the input option and output option.

Casing

Specifies the casing of the output.

Native
Output will be based on the reference database standard.
Upper
Output will be in upper case for all countries.
Lower
Output will be in lower case for all countries.
Mixed
Casing determined by country-specific rules.
No change
For parse mode, returns the data the way it was entered. For validation mode, uses the casing found in the reference data and according to postal rules. Values that could not be checked against the reference data will retain their input casing.

Alphabets for Non-Latin 1 Countries

For countries that use an alphabet other than Latin I, the returned alphabet differs from country to country. The following table shows how the output is returned for specific countries. All countries that are not listed use the value specified in the Script/Alphabet field option.

Country Database Postal admin preferred Postal admin alternate Latin Latin alternate ASCII simplified ASCII extended
RUS Cyrillic Cyrillic Cyrillic CYRILLIC_ISO CYRILLIC_BGN CYRILLIC_ISO + LATIN_SIMPLE CYRILLIC_ISO + LATIN
JPN Kanji Kanji Kana JAPANESE JAPANESE JAPANESE + LATIN_SIMPLE JAPANESE + LATIN
CHN Hanzi Hanzi Hanzi CHINESE_ MANDARIN CHINESE_ CANTONESE CHINESE_ MANDARIN + LATIN_SIMPLE CHINESE_ MANDARIN + LATIN
HKG Hanzi Hanzi Hanzi CHINESE_ CANTONESE CHINESE_ MANDARIN CHINESE_ CANTONESE + LATIN_SIMPLE CHINESE_ CANTONESE + LATIN
TWN Hanzi Hanzi Hanzi CHINESE_ CANTONESE CHINESE_ MANDARIN CHINESE_ CANTONESE + LATIN_SIMPLE CHINESE_ CANTONESE + LATIN
GRC Greek Greek Greek GREEK_ISO GREEK_BGN GREEK_ISO + LATIN_SIMPLE GREEK_ISO + LATIN
KOR Latin Hangul Hanja KOREAN KOREAN KOREAN + LATIN_SIMPLE KOREAN + LATIN
ISR Latin Hebrew Hebrew HEBREW HEBREW HEBREW + LATIN_SIMPLE HEBREW + LATIN
ROM Latin-3 Latin-3 Latin-3 Latin-3 Latin-3 LATIN_SIMPLE LATIN
POL Latin-2 Latin-2 Latin-2 Latin-2 Latin-2 LATIN_SIMPLE LATIN
CZE Latin-2 Latin-2 Latin-2 Latin-2 Latin-2 LATIN_SIMPLE LATIN
CRI Latin-2 Latin-2 Latin-2 Latin-2 Latin-2 LATIN_SIMPLE LATIN
HUN Latin-2 Latin-2 Latin-2 Latin-2 Latin-2 LATIN_SIMPLE LATIN
MDA Latin-2 Latin-2 Latin-2 Latin-2 Latin-2 LATIN_SIMPLE LATIN
SVK Latin-2 Latin-2 Latin-2 Latin-2 Latin-2 LATIN_SIMPLE LATIN
LAT Latin-7 Latin-7 Latin-7 Latin-7 Latin-7 LATIN_SIMPLE LATIN