オプション

以下の表に、ValidateAddressLoqate が返す情報の種類を制御するオプションの一覧を示します。

表 1. 出力データ オプション

オプション名

説明

Database.Loqate

国際住所の妥当性の確認に使用するデータベースを指定します。国際住所検証用のデータベースを指定するには、[データベース] ドロップダウン リストからデータベースを選択します。

OutputFieldLevelReturnCodes

フィールドレベルの結果インジケータを含めるかどうかを指定します。フィールドレベルの結果インジケータは、ValidateAddressLoqate が各住所要素をどのように処理したかを示します。フィールドレベルの結果インジケータは、修飾子 "Result" で返されます。例えば、HouseNumber のフィールドレベルの結果インジケータは HouseNumber.Result に格納されます。結果インジケータの出力フィールドの完全な一覧は、結果インジケータを参照してください。

N
フィールドレベルのリターン コードを出力しません (デフォルト)。
Y
フィールドレベルのリターン コードを出力します。

OutputFormattedOnFail

住所の妥当性を確認できない場合に書式を整えた住所を返すかどうかを指定します。住所には、その国の標準住所書式が設定されます。このオプションを選択しない場合、ValidateAddressLoqate が住所の妥当性を確認できないと、出力住所フィールドは空白になります。

N
失敗した住所の書式を整えません (デフォルト)。
Y
失敗した住所の書式を整えます。

[標準住所を含める][住所行の要素を含める]、および [郵便情報を含める] の各チェック ボックスで指定されたフォーマットを使用して、書式を整えた住所が返されます。[住所行の要素を含める] を選択した場合は、妥当性が確認できた住所に対しては、パース済みで妥当性を確認済みの住所が、パース済み住所要素に含まれることに注意してください。住所の妥当性が確認できなかった場合には、パース済み住所要素には、入力住所がパース済み形式で含まれることになります。ValidateAddressLoqate が住所の妥当性を確認できたかどうかにかかわらず、必ず入力住所をパース済み形式で出力したい場合は、[正規化された入力住所要素を含める] を選択します。

このオプションをオンにする場合は、[標準住所を含める][住所行の要素を含める] またはそのいずれかを選択する必要があります。

OutputRecordType オプションで指定されたフォーマットを使用して、書式を整えた住所が返されます。OutputRecordType=E を指定した場合は、妥当性が確認できた住所に対しては、パース済みで妥当性を確認済みの住所が、パース済み住所要素に含まれることに注意してください。住所の妥当性が確認できなかった場合には、パース済み住所要素には、入力住所がパース済み形式で含まれることになります。ValidateAddressLoqate が住所の妥当性を確認できたかどうかにかかわらず、必ず入力住所をパース済み形式で出力したい場合は、OutputRecordType=I を指定します。

Y を指定する場合は、OutputRecordType に対して "A" と "E" またはそのいずれかを指定する必要があります。

Option.OutputRecordType オプションで指定されたフォーマットを使用して、書式を整えた住所が返されます。Option.OutputRecordType=E を指定した場合は、妥当性が確認できた住所に対しては、パース済みで妥当性を確認済みの住所が、パース済み住所要素に含まれることに注意してください。住所の妥当性が確認できなかった場合には、パース済み住所要素には、入力住所がパース済み形式で含まれることになります。ValidateAddressLoqate が住所の妥当性を確認できたかどうかにかかわらず、必ず入力住所をパース済み形式で出力したい場合は、Option.OutputRecordType=I を指定します。

OutputAddressBlocks

実際の郵便物に印字される、書式を整えた住所を返すかどうかを指定します。住所の各行が、別々の住所ブロック フィールドに入れて返されます。AddressBlock1 から AddressBlock9 まで、最大 9 つの住所ブロック出力フィールドが使用されます。

例えば、以下の住所入力の場合、

AddressLine1: 4200 Parliament Place
AddressLine2: Suite 600
City: Lanham
StateProvince: MD
PostalCode: 20706

以下の住所ブロックが出力されます。

AddressBlock1: 4200 PARLIAMENT PL STE 600
AddressBlock2: LANHAM MD 20706-1882
AddressBlock3: UNITED STATES OF AMERICA

ValidateAddressLoqate は、郵便当局の規格に従って住所の書式を整え、住所ブロックの形式にします。国名は、万国郵便連合 (UPU) の国名で返されます。OutputCountryFormat オプションは、住所ブロックの国名には影響を与えないことに注意してください。[国フォーマット] オプションは、Country 出力フィールドに返される名前のみに影響を与えます。

次のいずれかです。

N
住所ブロックを返しません。こちらがデフォルトです。
Y
住所ブロックを返します。

AmasFormatting

Address Matching Approval System (AMAS) 表記を使用して出力住所データをフォーマットすることを指定します。

このオプションを使用すると、Validate Address Loqate は、住所を正規化するときに AMAS ルールを使用するようになります。AMAS は、オーストラリア郵政公社が定める、住所規格を徹底するためのプログラムです。AMAS 書式設定表記の詳細については、『Address Matching Approval System (AMAS) Handbook』を参照してください。

このオプションを使用すると、出力データは次のように変更されます。

  • 数値フィールドにはゼロが付加されます。この影響を受けるのは、HouseNumber、HouseNumber2、PostalDeliveryNumber、および DPID の各出力フィールドです。例えば、入力フィールドが 298 New South Head Rd Double Bay NSW 2028 の場合、HouseNumber フィールドの形式は 298 から 00298 に変更されます。
  • 一致しない場合、DPID フィールドの桁はすべてゼロになります。例えば、00000000 などです。
  • 一致しない場合、すべてゼロを含む数値フィールドを除き、すべてのリターン フィールド (パース済み住所要素) が空白になります。
  • CCD フィールドは出力されません。

有効な値は、次のとおりです。

N
AMAS 表記を使用して出力データをフォーマットしません (デフォルト)。
Y
AMAS 表記を使用して出力データをフォーマットします。
注: このオプションを選択すると、[許容レベル] フィールドと [最小マッチ スコア] フィールドの選択に関わらず、AMAS フォーマットで結果が返されます。

OutputCasing

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

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

123 Main St
Mytown FL 12345

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

123 MAIN ST
MYTOWN FL 12345

HomeCountry

デフォルト国を指定します。大部分の住所が存在する国を指定してください。例えば、処理する住所の大部分がドイツにある場合は、ドイツを指定します。ValidateAddressLoqate は、[StateProvince]、[PostalCode]、および [Country] の各住所フィールドから国を特定できなかった場合、指定された国を使用して、住所の検証を試みます。有効な国名には次のものがあります。

Afghanistan, Albania, Algeria, American Somoa, Andorra, Angola, Anguilla, Antigua And Barbuda, Argentina, Armenia, Aruba, Australia, Austria, Azerbaijan, Bahamas, Bahrain, Bangladesh, Barbados, Belarus, Belgium, Belize, Benin, Bermuda, Bhutan, Bolivia, Bosnia And Herzegovina, Botswana, Brazil, British Virgin Islands, Brunei Darussalam, Bulgaria, Burkina Faso, Burundi, Cambodia, Cameroon, Canada, Cape Verde, Cayman Islands, Central African Republic, Chad, Chile, China, Colombia, Comoros Islands, Congo, Cook Islands, Costa Rica, Cote D'Ivoire, Croatia, Cuba, Cyprus, Czech Republic, Democratic Republic Of Congo, Denmark, Djibouti, Dominica, Dominican Republic, East Timor, Ecuador, Egypt, El Salvador, Equitorial Guinea, Eritrea, Estonia, Ethiopia, Falkland Islands, Faroe Islands, Federated States Of Micronesia, Fiji, Finland, France, French Guiana, Gabon, Gambia, Germany, Ghana, Gibraltar, Greece, Greenland, Grenada, Guadeloupe, Guam, Guatemala, Guinea, Guinea Bissau, Guyana, Haiti, Holy See, Honduras, Hong Kong, Hungary, Iceland, India, Indonesia, Iran, Iraq, Ireland, Israel, Italy, Jamaica, Japan, Jordan, Kazakhstan, Kenya, Kiribati, Korea, Kuwait, Kyrgyzstan, Laos, Latvia, Lebanon, Lesotho, Liberia, Libya, Liechtenstein, Lithuania, Luxembourg, Macau, Macedonia, Madagascar, Malawi, Malaysia, Maldives, Mali, Malta, Marshall Islands, Martinique, Mauritania, Mauritius, Mayotte, Mexico, Moldova, Monaco, Mongolia, Monserrat, Morocco, Mozambique, Myanmar, Namibia, Nauru, Nepal, Netherlands Antilles, New Caledonia, New Zealand, Nicaragua, Niger, Nigeria, Niue, Norway, Oman, Pakistan, Palau, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Pitcairn Islands, Poland, Portugal, Puerto Rico, Qatar, Republic Of Georgia, Republic Of Korea, Republic Of Singapore, Reunion, Romania, Russia, Rwanda, Saint Helena, Saint Kitts And Nevis, Saint Lucia, Saint Pierre And Miquelon, Saint Vincent And The Grenadines, Samoa, San Marino, Sao Tome And Principe, Saudi Arabia, Senegal, Seychelles, Sierra Leone, Slovakia, Slovenia, Solomon Islands, Somalia, South Africa, Spain, Sri Lanka, Sudan, Surivalue, Swaziland, Sweden, Switzerland, Syria, Tahiti, Taiwan, Tajikistan, Tanzania, Thailand, The Netherlands, Togo, Tonga, Trinidad And Tobago, Tristan Da Cunha, Tunisia, Turkey, Turkmenistan, Turks And Caicos Islands, Tuvalu, Uganda, Ukraine, United Arab Emirates, United Kingdom, United States, Uruguay, Uzbekistan, Vanuatu, Venezuela, Vietnam, Virgin Islands (US), Wallis And Futuna, Yemen, Yugoslavia, Zambia, Zimbabwe

OutputCountryFormat

Country 出力フィールドに返される国名に使用するフォーマットを指定します。例えば、英語を選択した場合、"Deutschland" という国名は "Germany" として返されます。

E
英語の国名を使用します (デフォルト)。
I
国名の代わりにその国の 2 文字の ISO の略語を使用します。
U
国名の代わりにその国の万国郵便連合 (Universal Postal Union: UPU) の略語を使用します。

OutputScript

出力がどのアルファベットまたはスクリプトで返されるかを指定します。このオプションは双方向で、通常はネイティブからラテン文字へ、およびラテン文字からネイティブへ実行されます。

Input
書き直しを実行せず、入力と同じスクリプトで出力します (デフォルト)。
Native
使用可能な場合は、選択した国のネイティブ スクリプトで出力します。
Latn
英語の値を使用します。
許容レベル

AcceptanceLevel

レコードが正常に処理されたとみなされるために達成する必要のある、最小検証レベルを指定します。このフィールドの値は、“処理後検証マッチ レベル” と呼ばれる、Address Verification Code の 2 つめの文字に対応します。

  • 5 — 配達ポイント (建物または郵便受け)。入力レコードの ApartmentNumber、HouseNumber、Street、City、StateProvince が、Loqate のリファレンス データセットと一致する場合、レコードは引き渡されるか、高い確信レベルを付与されます。ApartmentNumber は正しいがその他のフィールドが正しくない場合、確信レベルは中程度になりますが、ApartmentNumber は他のフィールドよりも細かいレベルであるため、Loqate エンジンはこの場合に、ApartmentNumber を特定できるはずです。Loqate エンジンが ApartmentNumber とその他のフィールドをパーシングできない場合は、確信レベルは 0 となります。
  • 4 — 敷地または建物。入力レコードの HouseNumber、Street、City、StateProvince が、Loqate のリファレンス データセットと一致する場合、レコードは引き渡されるか、高い確信レベルを付与されます。HouseNumber は正しいがその他のフィールドが正しくない場合、確信レベルは中程度になりますが、HouseNumber は他のフィールドよりも細かいレベルであるため、Loqate エンジンはこの場合に、HouseNumber を特定できるはずです。Loqate エンジンが HouseNumber とその他のフィールドをパーシングできない場合は、確信レベルは 0 となります。
  • 3 — 大ストリート、道路、またはストリート。入力レコードの Street、City、StateProvince が、Loqate のリファレンス データセットと一致する場合、レコードは引き渡されるか、高い確信レベルを付与されます。City は正しいが StateProvince が正しくない場合、確信レベルは中程度になりますが、City は StateProvince に含まれるため、Loqate エンジンはこの場合に、StateProvince を特定できるはずです。Loqate エンジンが City または両方のフィールド (City と StateProvince) をパーシングできない場合は、確信レベルは 0 となります。
  • 2 — 地方 (都市または町)。入力レコードの City と StateProvince の両方が、Loqate のリファレンス データセットと一致する場合、レコードは引き渡されるか、高い確信レベルを付与されます。City は正しいが StateProvince が正しくない場合、確信レベルは中程度になりますが、City は StateProvince に含まれるため、Loqate エンジンはこの場合に、StateProvince を特定できるはずです。Loqate エンジンが City または両方のフィールド (City と StateProvince) をパーシングできない場合は、確信レベルは 0 となります。
  • 1 — 行政区域 (州または地域)。入力レコードの StateProvince が、Loqate のリファレンス データセットと一致する場合、レコードは引き渡されるか、高い確信レベルを付与されます。
  • 0 — なし。これは、最も制限の緩いマッチ オプションと同じです。

IsDuplicateHandlingMaskEnable

重複処理マスクを有効にし、重複レコードの処理および削除の方法を指定します。次のオプションから 1 つ以上を選択します。

S
デフォルトで選択されています。入力の前処理により、単一フィールドで発生している重複を削除します。
C
デフォルトで選択されています。入力の前処理により、すべてのフィールドわたって重複を削除します。
T
入力の前処理により、標準住所フィールドでないフィールド内の重複を削除します。
F
デフォルトで選択されています。検証の出力の後処理により、検証されていないフィールドから重複を削除します。

MinimumMatchScore

Validate Address Loqate において、Loqate 参照データベースでマッチ結果を得るために、住所に加える変更の度合いを、0 ~ 100 の間の数値で指定します。数値が小さいほど、大きな変更が許容されます。100 の値は、パーシング後に入力住所と検証済み住所がほぼ同一であることを意味します。0 の値は、検証済み住所を得るためにパーシング後の入力住所を大きく変更してしまってもよいことを意味します。

KeepMultimatch

一致する可能性のある住所を複数持つ入力住所に対して複数の住所を返すかどうかを指定します。

Y
複数のマッチを返します (デフォルト)。
N
複数のマッチを返しません。

詳細については、複数マッチを返すを参照してください。

FailMultipleMatches

一致する可能性のある住所が複数存在する入力住所に対して、複数の住所を許可しません。