ValidateAddress は、郵便当局の住所データを使用して、住所を正規化し、妥当性を確認します。ValidateAddress は、情報を修正し、管轄の郵便当局が推奨する書式で住所の書式を整えることができます。また、郵便番号、都市名、州/省名など、欠落している郵便情報を追加します。
ValidateAddress は、ValidateAddress が住所の妥当性を確認したかどうか、返した住所の確信レベル、住所の妥当性が確認できなかった場合はその理由など、バリデーション処理に関する結果インジケータも返します。
ValidateAddress は、住所のマッチングと正規化において、住所行をコンポーネントに分割し、それらを Universal Addressing モジュールの各種データベースの内容と比較します。マッチを検出した場合、入力住所をデータベース情報に合わせて正規化します。データベースにマッチしなかった場合、ValidateAddress は、オプションで入力住所の書式を整えます。書式設定プロセスでは、該当する郵便当局の規則に従って住所行の構成を試みます。
ValidateAddress は、Universal Addressing モジュールに含まれています。
リソース URL
JSON エンドポイント:
http://server:port/rest/ValidateAddress/results.json
XML エンドポイント:
http://server:port/rest/ValidateAddress/results.xml
JSON 応答の例
次の例では、JSON 応答を要求します。
http://myserver:8080/rest/ValidateAddress/results.json?Data.AddressLine1=1825+Kramer+Ln&Data.PostalCode=78758
この要求から次のような JSON が返されます。
{"output_port": [{
"Confidence": "100",
"RecordType": "Normal",
"CountryLevel": "A",
"ProcessedBy": "USA",
"MatchScore": "0",
"AddressLine1": "1825 Kramer Ln",
"City": "Austin",
"StateProvince": "TX",
"PostalCode": "78758-4260",
"Country": "United States Of America",
"PostalCode.Base": "78758",
"PostalCode.AddOn": "4260",
"user_fields": []
}]}
XML 応答の例
次の例では、XML 応答を要求します。
http://myserver:8080/rest/ValidateAddress/results.xml?Data.AddressLine1=1825+Kramer+Ln&Data.PostalCode=78758
この要求から次のような XML が返されます。
<ns2:xml.ValidateAddressResponse xmlns:ns2="http://www.pb.com/spectrum/services/ValidateAddress">
<ns2:output_port>
<ns2:Address>
<ns2:Confidence>93</ns2:Confidence>
<ns2:RecordType>Normal</ns2:RecordType>
<ns2:CountryLevel>A</ns2:CountryLevel>
<ns2:ProcessedBy>USA</ns2:ProcessedBy>
<ns2:MatchScore>0</ns2:MatchScore>
<ns2:AddressLine1>1825 Kramer Ln</ns2:AddressLine1>
<ns2:City>Austin</ns2:City>
<ns2:StateProvince>TX</ns2:StateProvince>
<ns2:PostalCode>78758-4260</ns2:PostalCode>
<ns2:PostalCode.Base>78758</ns2:PostalCode.Base>
<ns2:PostalCode.AddOn>4260</ns2:PostalCode.AddOn>
<ns2:Country>United States Of America</ns2:Country>
<ns2:user_fields/>
</ns2:Address>
</ns2:output_port>
</ns2:xml.ValidateAddressResponse>