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

住所の修正 - 例

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

一般的な例: 修正

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

市区町村と郵便番号がありません

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

住所を入力しました	地域
六本木 6-10-1	米国

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

以下の例では、レスポンスからの重要なシグナルを重視しています。

{
  "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 として返されます。地域区分や郵便番号などの重要なデータが省略されています。

番地が未入力

この例では、番地が欠落しています。

住所を入力しました	地域
バッキンガムパレスロード、SW1W 9TQ London	UK

番地がないという判定結果

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

validationGranularity は ROUTE で、道路と一致することを示しますが、建物に入るには情報が十分ではありません。また、addressComplete プロパティが判定結果に含まれていないため、false になっています。さらに address オブジェクトに対してクエリを実行すると、不足しているコンポーネントタイプが明らかになります。

"missingComponentTypes": [
        "street_number"
      ]

エッジケースの例: 修正

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

未確認の番地

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

住所を入力しました	地域
84 Buckingham Places Road, SW1W 9TQ, London	UK

未確認の番地に対する判定

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

{
  "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 が提供され、これは建物の棟が欠落していることを示しています。