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

このドキュメントでは、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
}