このドキュメントでは、Address Validation API からのさまざまなレスポンスを処理するアドレスチェック システムを作成するプロセスについて説明します。レスポンスの正しい使用、API からのその他のシグナルの調査、お客様に詳細情報を尋ねるタイミングと方法に関するロジックを構築する方法について説明します。
一般に、API レスポンスから、システムが住所を処理する方法が決まります。
- 修正 - 住所の品質が低い。 詳細を尋ねる必要があります。
- 確認 - 住所は高品質ですが、入力された住所と異なります。確認を求めるメッセージが表示される場合があります。
- 承認 - 住所の品質が高い。指定された住所を承認できます。
鍵の目的
このドキュメントは、API レスポンスを適切に分析し、指定された住所に対して行う次のアクションを決定できるようにシステムを変更するうえで役立ちます。次の疑似コードは、考えられるフローを示しています。
if (the API response indicates significant problems in the address)
FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
CONFIRM - confirm with the user that the address is correct
else
ACCEPT - continue with the address returned by the API.
具体的なロジックは状況によって異なります。詳しくは、実装ガイダンスをご覧ください。拡張コンポーネント ライブラリにある、このロジックのオープンソース実装を使用することもできます。
ワークフローの概要
次の表に、システムの 2 つのアクションをまとめます。
- 修正、確認、承認の動作に基づく使用するワークフロー。
- レスポンスから確認する最初のシグナル。ここで説明するシグナルは
verdictプロパティから取得されます。これは、確認する唯一のシグナルではないものの、アドレスの品質に関する最初の指標となります。各動作タイプは、調査が必要なその他のシグナルについて説明しているこのドキュメントのセクションに対応しています。
| システムの動作 | |||
|---|---|---|---|
| 住所を修正する |
|
||
| 住所を確認する |
|
||
| 住所を承認する |
Address Validation API のレスポンスは、優れた品質のアドレスを示しています。
|
||
導入に関するアドバイス
Address Validation API からのシグナルにシステムがどのように応答するかを設計する際は、次の推奨事項に沿って、より効果的なレスポンス モデルを構築してください。ただし、これらはあくまで推奨事項であり、実装はビジネスモデルに合わせて行う必要があります。
| ガイダンス | 詳細 | |
|---|---|---|
| リスクレベル |
修正を求めるメッセージと、入力された住所をそのまま受け入れるメッセージのバランスを取る際は、状況に応じた許容レベルを考慮してください。 |
Address Validation API は、さまざまなシグナルを返します。これらのシグナルは、リスクレベルに組み込んで検証プロセスを最適化できます。 たとえば、住所に未確認の番地が含まれている場合でも、その住所を承認できます。一方、ビジネス運営で住所の精度を高める必要がある場合は、ユーザーにプロンプトを表示できます。どちらのカテゴリにも該当する可能性がある例については、住所の承認 - 例の米国以外の未確認の番地をご覧ください。 |
| 住所を承認する |
お客様がプロンプトに応答しない場合、システムで元のエントリを受け入れるようにすることをおすすめします。 |
この場合、お客様がシステムに登録されていない住所（新築など）を入力している可能性があります。 |
| フィードバックを送信する |
住所の検証リクエストを再発行するときに、 |
これにより、最終的な回答を最終的にどのように処理したかを Google に知らせることができます。 住所の更新に対応するをご覧ください。 |
住所を修正
住所が配送不可であることが明確に示されている場合は、住所を修正します。システムは、必要な情報を提供するようお客様にプロンプトを表示できます。その後、ワークフローを再発行して配送先住所を取得します。
シグナルを修正する
Address Validation API は、アドレスを修正する必要があるかどうかを示すさまざまなシグナルを提供します。
1. 検証の粒度と不足しているコンポーネント
問題のある住所を示す最も有力なシグナルは次の 2 つです。
validationGranularityフィールドがOTHERの場合、システムはアドレス コンポーネント シグナルを調査して、エラーが発生した場所とその修正方法の詳細を確認する必要があります。- 後処理された
addressオブジェクトがmissingComponentTypesフィールドを返すたびに、システムはそのコンポーネントを確認する必要があります。コンポーネントが欠落している場合も、住所が不完全で配達不可となります。
2. その他のシグナル
Address Validation API には、特定の問題の診断に役立つ他のシグナルも用意されています。
| 不審なコンポーネント | コンポーネントの確認レベルの列挙型が UNCOMFIRMED_AND_SUSPICIOUS の場合、コンポーネントが正しくありません。 |
|---|---|
| 未解決のコンポーネント | unresolvedToken は、住所の有効な部分として認識されない入力の一部です。 |
3. 米国の住所シグナル
米国の住所にのみ適用される特定のフィールドは、住所が配送不可であり修正が必要なことを示す有用なシグナルとなります。修正が必要な住所には、次のように表示されます。
dpvConfirmation
|
N、D、空のいずれか。 |
|---|
dpvConfirmation の詳細については、米国の住所を処理するをご覧ください。
住所を確認する
判定結果で、Address Validation API が検証済みの住所を生成するために住所の構成要素を推測または変更したことが示されている場合は、住所を確認します。このような場合、配送先住所はありますが、その住所がお客様が意図した住所であることを確認したい場合。
お客様に正しいメッセージを表示するには、サービスによってフラグが立てられたコンポーネントを特定し、API がコンポーネントに適用したアクションまたはフラグ（inferred、replaced、spellCorrected など）を判断します。リファレンスの AddressComponent をご覧ください。
シグナルを確認する
Address Validation API には、アドレスを確認する必要があるかどうかを判断するためのさまざまなシグナルが用意されています。
1. 検証の粒度
validationGranularity が ROUTE 以上であれば問題ありませんが、PREMISE または SUBPREMISE の方が配信可能性のシグナルが強くなります。
2. その他のシグナル
お客様に住所の入力を確認することを決定した場合、判定結果には、調査するコンポーネントを判断するための次の情報も表示されます。
| 推論データ | hasInferredComponents フィールドが true の場合、API が他の住所コンポーネントから収集した情報を入力したことがわかります。 |
|---|---|
| 置換されたデータ | hasReplacedComponents フィールドが true の場合、API は入力されたデータを、住所を有効にすると判断したデータに置き換えました。 |
3. 米国の住所シグナル
米国の住所にのみ適用される特定のフィールドは、ロジックでお客様に詳細を確認する必要があることを示します。次のいずれかになります。
dpvConfirmation
|
S
|
|---|---|
| 住所に関する回答 | subpremise の値を持つ missingComponentType フィールドが含まれています。 |
住所を承認する
アドレスが配達可能であり、ダウンストリーム プロセスでお客様の追加の操作なしで使用できることが判定結果から高い信頼性で示されている場合は、アドレスを承認します。
シグナルを承認する
Address Validation API には、アドレスを確認する必要があるかどうかを判断するためのさまざまなシグナルが用意されています。
1. 検証の粒度
validationGranularity が PREMISE 以上であれば問題ありませんが、場合によっては ROUTE でも配達可能な住所を示します。
2. その他のシグナル
高品質な住所の判定結果には、次の情報も含まれる必要があります。
- 置き換えられたデータなし。この場合は
hasReplacedComponents: FALSEです。 - 推論されたコンポーネントなし。この場合は
hasInferredComponents: FALSEです。
3. 米国の住所シグナル
米国の住所にのみ適用される特定のフィールドは、配送可能な高品質の住所を示します。米国の住所が有効な場合は、次のように表示されます。
dpvConfirmation
|
Y
|
|---|