Address Verification Cloud Serviceの使用
Oracle Address Verification Cloud Serviceでは、アプリケーションの住所を確認(mode=V)および検索(mode=S)できます。次の形式でREST APIにアクセスします: https://serviceName-identityDomain.data.us2.oraclecloud.com/av/api。例: https://datatrial1234-usoracletrial1234.data.us2.oraclecloud.com/av/api/v2/addressclean。
住所の確認
-
住所が有効かどうか確認します(
addressclean)。 -
住所を修正および補正します。たとえば、入力に誤りがある市区町村や番地名を修正し、完全な郵便番号や都道府県など、欠落している要素を追加し、緯度、経度などの地理的な場所を取得できます。
-
郵便ファイルから住所の正確な表記を取得します。たとえば、「street」を「St」、「parkw」を「Pkwy」に変更します。
-
住所を音訳します。たとえば、アラビア語で住所を入力し、英語で確認済の出力を取得できます。これは母国語からラテン語(英語)へのoutputscript、またはラテン語(英語)から母国語へのoutputscriptでサポートされます。
OutputScriptオプションでは現在、次の値がサポートされています。-
Latn – ラテン語(可能な場合は英語表記に変換)
-
Cyrl – キリル言語(ロシア)
-
Grek – ギリシャ語(ギリシャ)
-
Hebr – ヘブライ語(イスラエル)
-
Hani – 漢字(日本語)
-
Hans – 簡体字中国語(中国)
-
Arab – アラビア語(アラブ首長国連邦)
-
Thai – タイ語(タイ)
-
Hang – ハングル(韓国)
-
Native – 可能な場合はネイティブ・スクリプトで出力
-
指定された構成に従って結果が確認または変更された場合は、verified=Yになります。デフォルトでは、オプションが指定されていない場合、出力スクリプトは可能な限り入力に一致します。
注意:
有効な住所を持っていることがわかっており、標準化する場合以外は、minimumverificationmatchscoreを100に設定しないでください。通常、国のデフォルトのminimumverificationlevelを使用します(例: US=4)。例外は、郵便番号を確認する必要がある場合です。住所の検索
city、cityなど)、検索(S)モードを指定します。応答では、APIはレコードのリスト(この入力で何も見つからなかった場合は、verified="None"を含む1件のレコード)を返します。注意:
検索モードでは、address2、address3、address4には何も入力しないでください。詳細は、Oracle Address Verification Cloud ServiceのREST APIを参照してください。
RESTクライアントを使用したAddress Verification Cloud Serviceへのコール
- SoapUIで、「ファイル」→新規RESTプロジェクトを選択します。
-
Address Verification Cloud ServiceのURL(
http://host:port/av/api/v2/addressclean)を入力します。 -
新規RESTプロジェクトで、認証をクリックして、新規認証を追加します。
-
認証タイプとして基本を選択します(存在しない場合は作成します)。
-
ユーザー認証情報を入力し、事前に認証を選択します。
-
「メソッド」リストから、投稿を選択します。
-
「メディア・タイプ」(application/json)ウィンドウに要求を入力します。例:
[{"addressid":"234", "address1":"300 ORACLE PKWY", "address2":"", "address3":"", "address4":"", "city":"REDWOOD CITY", "postalcode":"94065 ", "country":"US", "defaultcountrycode":"", "charcase":"M", "mode":"V", "minimumverificationmatchscore":"70", "allowedverificationresultcodes":"V"}] -
要求を発行します。成功すると、出力レコードが送り返されます。
