オプション

表 1. GetCandidateAddresses オプション

オプション名

説明

米国住所処理を有効にする

米国住所を処理するかどうかを住所をサポートしていません。米国住所処理を有効にすると、GetCandidateAddresses は、米国住所の候補となる住所の取得を試みます。米国住所処理を無効にすると、米国住所は失敗します。つまり、Status 出力フィールドに "F" が設定されて返されます。出力フィールド Status.Code は、"DisabledCoder" となります。米国住所処理のライセンスを取得していない場合は、ジョブに米国住所が含まれるか否かにかかわらず、米国住所処理を無効にしなければ、ジョブを正常に実行することはできません。

注: 米国住所を正常に処理するには、米国住所処理の有効なライセンスを取得する必要があります。米国住所処理のライセンスを取得していないか、ライセンスの期限が切れているにもかかわらず、米国住所処理を有効にすると、ジョブ全体が失敗します。

データベース

米国住所処理に使用するデータベースを指定します。Management Console の [米国データベース リソース] パネルで定義されたデータベースのみが使用可能です。

カナダ住所処理を有効にする

カナダ住所を処理するかどうかを指定します。カナダ住所処理を有効にすると、GetCandidateAddresses は、カナダ住所の候補となる住所の取得を試みます。カナダ住所処理を無効にした場合、Status フィールドに "F" が設定されカナダ住所は失敗します。出力フィールド Status.Code は、"DisabledCoder" となります。カナダ住所処理のライセンスを取得していない場合は、ジョブにカナダ住所が含まれるか否かにかかわらず、カナダ住所処理を無効にしなければ、ジョブを正常に実行することはできません。

注: カナダ住所を正常に処理するには、カナダ住所処理の有効なライセンスを取得する必要があります。カナダ住所処理のライセンスを取得していないか、ライセンスの期限が切れているにもかかわらず、カナダ住所処理を有効にすると、ジョブ全体が失敗します。

データベース

カナダ住所処理に使用するデータベースを指定します。Management Console の [カナダ データベース リソース] パネルで定義されたデータベースのみが使用可能です。

国際住所処理を有効にする

国際住所 (米国およびカナダ以外の住所) を処理するかどうかを指定します。国際住所処理を有効にすると、GetCandidateAddresses は、国際住所の候補となる住所の取得を試みます。国際住所処理を無効にした場合、Status フィールドに "F" が設定され国際住所は失敗します。出力フィールド Status.Code は、"DisabledCoder" となります。国際住所処理のライセンスを取得していない場合は、ジョブに国際住所が含まれるか否かにかかわらず、国際住所処理を無効にしなければ、ジョブを正常に実行することはできません。

注: 国際住所を正常に処理するには、国際住所処理の有効なライセンスを取得する必要があります。国際住所処理のライセンスを取得していないか、ライセンスの期限が切れているにもかかわらず、国際住所処理を有効にすると、ジョブ全体が失敗します。

データベース

国際的な住所の検証に使用するデータベースを指定します。Management Console の [国際データベース リソース] パネルで定義されたデータベースのみが使用可能です。

大文字小文字

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

混在
出力に大文字と小文字を混在させます (デフォルト)。例:

123 Main St
Mytown FL 12345

大文字
出力に大文字を使用します。例:

123 MAIN ST
MYTOWN FL 12345

返されるレコードの最大数

GetCandidateAddresses が返す候補住所の最大数。デフォルトは 10 です。最大数は 10 になります。

短い都市名を返す

米国住所に対しては、USPS® が承認する都市の略称がある場合に、それを返すかどうかを指定します。USPS® は、14 文字以上の都市名に対し、略称を定めています。都市の略称は 13 文字以下で、宛名ラベルのサイズが限られている場合に使用できます。短い都市名が存在しない都市に対しては、正式な都市名が返されます。

二重住所マッチ ロジック

(米国住所のみ)。ストリート情報と PO Box/地方配送路/Highway Contract 情報の両方が住所に含まれる場合に、GetCandidateAddresses が、ストリート一致を返すか、または PO Box/地方配送路/Highway Contract 一致を返すかを制御します。詳細については、二重住所ロジックについてを参照してください。

通常一致
(デフォルト) USPS®CASS™ の規則では、以下の優先順位に基づいて、返す住所を決定します。
  1. PO Box
  2. Firm
  3. Highrise
  4. ストリート
  5. Rural Route
  6. General Delivery
通りマッチング
住所行に関係なく、ストリート一致を返します。
PO Box 一致
住所行に関係なく、PO Box 一致を返します。

通りマッチング

ストリート名のマッチングの精度 (米国住所のみ)。

完全一致
入力されたストリート名は、データベースに完全に一致する必要があります。
厳格
マッチング アルゴリズムは "厳格" です。
マッチング アルゴリズムは "中" です (デフォルト)。
あいまい
マッチング アルゴリズムは "あいまい" です。

企業マッチング

企業名マッチングの精度 (米国住所のみ)。

完全一致
入力された企業名は、データベースに完全に一致する必要があります。
厳格
マッチング アルゴリズムは "厳格" です。
マッチング アルゴリズムは "中" です (デフォルト)。
あいまい
マッチング アルゴリズムは "あいまい" です。

道順マッチング

道順マッチングの精度。

完全一致
入力された道順は、データベースに完全に一致する必要があります。
厳格
マッチング アルゴリズムは "厳格" です。
マッチング アルゴリズムは "中" です (デフォルト)。
あいまい
マッチング アルゴリズムは "あいまい" です。

拡張ストリートマッチングを実行

Enhanced Street Matching (ESM) を実行するかどうかを指定します。ESM は、通常の住所検証プロセスでマッチしなかった任意の入力住所に対して、追加データによる別のマッチング ロジックを適用します。ESM は、米国住所にのみ適用されます。

失敗時に住所行を検索

ValidateAddress において、住所行で都市、州/省、郵便番号の検索を行うかどうかを指定します。

このオプションにより、ValidateAddress において、City、StateProvince、および PostalCode の各入力フィールドの値を使用して住所にマッチする結果が得られなかった場合に、AddressLine 入力フィールドで都市、州/省、郵便番号、および国を検索することができます。

入力住所において、AddressLine フィールドに都市、州/省、および郵便番号の情報が存在する場合は、このオプションを有効にすることを検討してください。

入力住所において、City、State/Province、および PostalCode フィールドが使用されている場合は、このオプションを無効にしてください。このオプションを有効にしてこれらのフィールドを使用すると、ValidateAddress がこれらのフィールド値の修正 (例えば、スペルミスのある都市名など) に失敗する可能性が高くなります。