このページは Cloud Translation API によって翻訳されました。

住所の修正 - 例

このドキュメントでは、Address Validation API がシステムの動作の修正を必要とするレスポンスシグナルを提供する、さまざまな実際のシナリオについて説明します。詳細については、検証ロジックを構築するのワークフローの概要をご覧ください。

一般的な例: fix

このセクションでは、Address Validation API が低品質のアドレス情報を示すレスポンスシグナルを提供する一般的な例について説明します。

市区町村と郵便番号がない

この例は、市区町村名や郵便番号のない住所のみを含むエントリを示しています。

入力した住所	地域
21 45 40th street	米国

市区町村と郵便番号が欠落しているという判定

次の例では、レスポンスの重要なシグナルを強調しています。

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

これらのシグナルは配達できない住所を示しているため、addressComponents をクエリして詳細を確認できます。

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

Address Validation API は、国（米国）のみを CONFIRMED として返します。他のすべての住所コンポーネントは UNCONFIRMED_BUT_PLAUSIBLE として返され、地域や郵便番号などの重要なデータが欠落します。

番地が未入力

この例は、番地が欠落していることを示しています。

入力した住所	地域
Buckingham Palace Road, SW1W 9TQ London	英国

番地が未入力の場合の判定

{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity が ROUTE の場合、通りに一致するものの、建物に入るには情報が不足しています。また、判定結果に addressComplete プロパティがないため、false です。address オブジェクトをさらにクエリすると、不足しているコンポーネントタイプが明らかになります。

"missingComponentTypes": [
        "street_number"
      ]

エッジケースの例: 修正

住所を修正、確認、承認するかどうかは、特定のビジネスシナリオによって異なります。以下の例は、厳密には修正カテゴリに該当しないシナリオを示しています。

番地が未確認

このシナリオでは、Address Validation API は指定された番地を確認できませんが、住所は完全であると示します。

入力した住所	地域
84 Buckingham Palace Road, SW1W 9TQ, London	英国

未確認の番地の判定結果

次の例では、重要なシグナルを強調しています。

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

検証の粒度を敷地レベルの近似値に限定し、未確認のコンポーネントと組み合わせて検討することをおすすめします。addressComponents プロパティのクエリでは、次の未確認の componentType が表示されます。

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

ここでは、street_number の confirmation_level が UNCONFIRMED_BUT_PLAUSIBLE に設定されています。[未確認] は、サービスがデータセット内の住所番号 84 と一致しないことを意味します。[妥当] は、コンポーネントデータが引き続き有効であることを意味します。

建物の棟がない

このシナリオでは、アパート番号や部門番号など、サブプレミスのみがない住所について説明します。それ以外の場合は、Address Validation API で住所を完全に検証できます。住所コンポーネントが欠落している場合と同様に、addressComplete は false であるため、判定結果を手動で検査しても表示されません。

たとえば、お客様がサンフランシスコ市の税務署の有効な住所を入力しても、部屋番号を入力しなかった場合、

入力した住所	地域
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102	米国

サブ前提が欠落している場合の判定

この例では、判定結果に addressComplete プロパティが表示されないため、false です。そのため、少なくとも 1 つのアドレス要素が予期しない、未解決、または欠落していることがわかります。

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true

}

address クエリを実行すると、次の結果が得られます。

"missingComponentTypes": [
        "subpremise"
      ]

詳しく調査したところ、USPS データの dpvConfirmation コードは D で、これもサブプレミスが欠落していることを示しています。