住所にサブプレミスを追加する - 例（米国のみ）

このドキュメントでは、Address Validation API がシステムからのサブプレミス追加動作を保証するレスポンス シグナルを提供する、実際のシナリオをいくつか紹介します。これらのシグナルは、米国の住所でのみ使用できます。コンテキストについては、検証ロジックを構築するのワークフローの例をご覧ください。

注: 以下の例は説明を目的としたものであり、すべてのシナリオを網羅しているわけではありません。

一般的な例: サブプレミスを追加する

このシナリオは、システムがお客様に住所にユニット番号を追加するよう求める可能性がある住所を示しています。

住所を入力しました	リージョン
1450 Brickell Avenue, Miami, FL 33131-4065	米国

サブプレミスが欠落している住所の判定

以下の例では、重要なシグナルをハイライト表示しています。

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

アクション: この住所の場合、ユーザーにユニット番号の追加を促すことができます。

特殊なケースの例: 建物内の場所を追加する

次の例は、verdict が、さらなる調査が必要なアドレス品質の問題を示している状況を示しています。この例では、判定から住所コンポーネントにロジックを移行して、より完全な情報を取得し、システム ロジックを強化する方法も示しています。

欠落しているサブプレミスと、推定および置換されたコンポーネント

この例は、地域が欠落し、郵便番号が間違っている米国の住所の入力を示しています。

住所を入力しました	リージョン
1450 Brickell Avenue, FL 33132-4065	米国

欠落しているサブプレミスと、推定および置換されたコンポーネントの判定

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "hasReplacedComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

住所の構成要素をさらに調査すると、地域が推測され、郵便番号が置き換えられていることがわかります。

{
   "componentName": {
     "text": "33131",
   }
   "componentType": "postal_code",
   "confirmationLevel": "CONFIRMED",
   "replaced": true
},
{
   "componentName": {
     "text": "Miami",
     "languageCode": "en"
   }
   "componentType": "locality",
   "confirmationLevel": "CONFIRMED",
   "inferred": true
}

対応: この住所については、ユーザーにユニット番号の追加を促すか、住所全体を確認するよう促します。