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

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

一般的な例: 建物内の区画を追加する

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

住所を入力済み 地域
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
}