住所を承認 - 例

このドキュメントでは、 Address Validation API は、受け入れ動作を保証するレスポンス シグナルを提供 確認できます。詳しくは、 ワークフローの概要: コンテキストについては、検証レスポンスを使用します。

一般的な例: 承認

このシナリオでは、システムで受信可能なアドレスが 入力します。

入力された住所 地域
東京都千代田区神田錦町 3-22 テラススクエア 8 階 | 03-4577-4401 | 英国

許容可能な住所の判定

以下の例では、重要なシグナルに注目しています。

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

さらに、レスポンスでは次のことが示されます。

  • hasUnconfirmedComponents は false のままです。
  • hasInferredComponents は false のままです。
  • hasReplacedComponents は false のままです。

これらのシグナルを組み合わせることで、住所の質が高くなります。

<ph type="x-smartling-placeholder">

エッジケースの例: 承認

次の例は、verdict が住所を示している状況を示しています。 品質に関する問題が報告されました。これらの例では 判定から住所コンポーネントまでロジックがどのように移動するかを システムロジックを強化するために、

米国以外の未確認の番地

この例は、すべての住所項目を含むイタリアの住所を入力しています 推定されるコンポーネントや 置き換えられるコンポーネントがない状態でただし、 validationGranularity は ROUTE です。

入力された住所 地域
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, イタリア IT

未確認の番地の判定

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

住所の構成要素を詳しく調査したところ、道路が 番号は UNCONFIRMED_BUT_PLAUSIBLE です。

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
<ph type="x-smartling-placeholder">

米国の未確認の番地

この例は、米国の住所とすべての住所項目を入力しています。 コンポーネントの推測や置き換えは生じません。ただし、 validationGranularity は PREMISE_PROXIMITY です。

入力された住所 地域
〒 101-0054 東京都千代田区神田錦町 3-22 US

未確認の番地に関する 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",
}
<ph type="x-smartling-placeholder">

確認済み住所に対する USPS データの不完全な部分

この例は、米国の住所とすべての住所項目を入力しています。 コンポーネントの推測や置き換えが行われていない状態で確認済みであり、 PREMISE 個中 validationGranularity 個目。ただし、uspsData は完全に 値が入力されていて、dpvConfirmation 値を含まない。

入力された住所 地域
155 Via Condado Way, パームビーチガーデンズ, FL US

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"
}
<ph type="x-smartling-placeholder">で確認できます。