オプション

表 1. GetGlobalCandidateAddresses のオプション

オプション名

説明/有効値

HomeCountry

デフォルト国を指定します。ほとんどの郵送物の宛先となる国を指定します。例えば、ほとんどの郵送先がカナダであれば、カナダを指定します。GetGlobalCandidateAddresses は、[StateProvince]、[PostalCode]、および [Country] の各住所フィールドから国を特定できなかった場合、指定された国を使用して、住所の検証を試みます。ISO コードの一覧は、ISO 国コードとモジュール サポートを参照してください。

OutputCasing

出力データの大文字と小文字の区別を指定します。次のいずれかです。

M
出力には、大文字と小文字が混在させます(デフォルト)。次に例を示します。123 Main St Mytown FL 12345
U
出力に大文字を使用します。次に例を示します。123 MAIN ST MYTOWN FL 12345

OutputCountryFormat

出力で国の名前として使うフォーマットを指定します。次のいずれかです。

E
出力の国名には英語表記を使います (デフォルト)。
I
出力の国名には 2 文字の ISO コードを使います。
U
出力の国名には 2 文字の UPU コードを使います。

ShowExtraAddressLine

都市、州/省、および郵便番号を [AddressLine] 出力フィールドのいずれかに格納するかどうかを指定します。このオプションの設定とは関係なく、出力フィールド [都市]、[州/省]、および [郵便番号] には常に都市、州/省、および郵便番号が格納されます。

Y
Y — 都市、州/省、および郵便番号を [AddressLine] 出力フィールドに格納します (デフォルト)。
N
N — 都市、州/省、および郵便番号を [AddressLine] 出力フィールドに格納しません。

OutputPostalCodeSeparator

ZIP™ Code またはカナダの郵便番号において、区切り文字 (スペースまたはハイフン) を使用するかどうかを指定します。

例えば、区切り文字ありの ZIP + 4® Code は 20706-1844、区切り文字なしは 207061844 になります。区切り文字ありのカナダの郵便番号は P5E"1S7、区切り文字なしは P5E1S7 になります。

Y
区切り文字を使います (デフォルト)。
N
区切り文字を使いません。
注: カナダの郵便番号ではスペースが、米国のZIP + 4® コードではハイフンが使用されます。

MaximumResults

出力する候補住所の最大数。デフォルトは 50 です。最大値は 100 です。

ReturnUserData

妥当性を確認できなかった入力住所を出力データに含めるかどうかを指定します。

Y
妥当性を確認できなかった入力データを含めます。
N
妥当性を確認できなかった入力データを含めません (デフォルト)。