このドキュメントでは、Address Validation API がシステムからの承認動作を保証するレスポンス シグナルを提供する、実際のシナリオについて説明します。コンテキストについては、検証レスポンスを使用するのワークフローの概要をご覧ください。
一般的な例: accept
このシナリオは、お客様が入力した住所をシステムが受け入れる住所を示しています。
入力した住所 | 地域 |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ | 英国 |
許可される住所の判定結果
次の例では、重要なシグナルをハイライト表示しています。
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
これに加えて、レスポンスには次の情報も含まれます。
hasUnconfirmedComponents
はfalse
のままです。hasInferredComponents
はfalse
のままです。hasReplacedComponents
はfalse
のままです。
これらのシグナルを組み合わせることで、高品質の住所を特定できます。
エッジケースの例: 承認
次の例は、verdict
が、詳細な調査が必要な住所品質の問題を示している状況を示しています。これらの例は、システム ロジックを強化するために、より完全な画像を取得するために、ロジックを判定結果から住所コンポーネントに転送する方法も示しています。
米国以外の未確認の番地
この例は、すべての住所コンポーネントが存在し、推定されたコンポーネントや置換されたコンポーネントがないイタリアの住所の入力を示しています。ただし、validationGranularity
は ROUTE
です。
入力した住所 | 地域 |
---|---|
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia | IT |
未確認の番地の判定結果
{
"inputGranularity": "SUB_PREMISE",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE",
"addressComplete": true,
"hasUnconfirmedComponents": true
}
住所の構成要素を詳しく調査したところ、番地が UNCONFIRMED_BUT_PLAUSIBLE
であることがわかりました。
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
米国の未確認の番地
この例は、すべての住所コンポーネントが存在し、推定されたコンポーネントや置換されたコンポーネントがない米国の住所の入力を示しています。ただし、validationGranularity
は PREMISE_PROXIMITY
です。
入力した住所 | 地域 |
---|---|
975 Carson Dr, Sunnyvale, CA 94086 | 米国 |
未確認の番地の USPS データ
{
"firstAddressLine": "975 CARSON DR",
"cityStateZipAddressLine": "SUNNYVALE CA 94086",
"city": "SUNNYVALE",
"state": "CA",
"zipCode": "94086"
"dpvConfirmation": "N",
"dpvFootnote": "AAM3",
"carrierRoute": "C031",
"carrierRouteIndicator": "D",
"postOfficeCity": "SUNNYVALE",
"postOfficeState": "CA",
"fipsCountyCode": "085",
"county": "SANTA CLARA",
}
確認済みの住所の USPS データが不完全
この例は、すべての住所コンポーネントが確認され、推定または置換されたコンポーネントがなく、validationGranularity
が PREMISE
の米国の住所の入力を示しています。ただし、uspsData
は完全に入力されておらず、dpvConfirmation
値は含まれていません。
入力した住所 | 地域 |
---|---|
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 | 米国 |
USPS データが不完全な確認済みの住所の判定結果
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
}
USPS データが不完全な確認済み住所の USPS データ
{
"standardizedAddress": {
"firstAddressLine": "155 VIA CONDADO WAY",
"cityStateZipAddressLine": "PALM BEACH GARDENS",
"city": "PALM BEACH GARDENS",
"state": "FL",
"zipCode": "33418"
},
"carrierRoute": "H018",
"postOfficeCity": "PALM BEACH GARDENS",
"postOfficeState": "FL"
}