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

住所の確認 - 例

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

一般的な例: 確認

次の例は、都市名が似ている大都市圏の場合を示しています。ユーザーが米国ワシントン州カークランドにある Google の建物 D の住所を入力するとします。しかし、都市のカークランドではなく、誤ってシアトルに入ります。

住所を入力しました	地域
Building D, 451 7th Avenue South, Seattle, WA 98033	米国

置き換えられたデータの判定

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

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

PREMISE_PROXIMITY は建物レベルの住所の近似値を示しますが、入力時に提供される粒度である SUB_PREMISE ほど詳細ではありません。レスポンスには、未確認のコンポーネントと置換されたコンポーネントの両方が含まれているため、この組み合わせによって confirm カテゴリにヒントが提供されます。

住所コンポーネントをクエリすると、次のような懸念事項が明らかになります。

{
  "componentName": {
    "text": "451",
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
...
{
  "componentName": {
    "text": "98104",
  },
  "componentType": "postal_code",
  "confirmationLevel": "CONFIRMED",
  "replaced": true
}
...
{
  "componentName": {
    "text": "Building D",
    "language_code": "en"
  },
  "componentType": "subpremise",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
.......

    "unconfirmedComponentTypes": [
      "street_number",
      "subpremise"
    ]

このケースでは、Address Validation API は、指定された住所に近似値であるシアトル内を検出し、高レベルのコンポーネントである郵便番号を置き換えて、シアトルの住所に解決します。有効な代替手段になる可能性もありますが、コンポーネントが未確認であることを考慮し、ユーザーがカークランドなど他の住所ではなく、シアトルの住所を入力するつもりであることを確認することは理にかなっています。

エッジケースの例: 確認

次の例は、次のエッジケースタイプを示しています。

確認されている軽微な推論。Address Validation API は国、郵便番号、州のいずれかを推定しますが、それ以外はすべて指定され、確認されます。粒度と確認レベルの両方を組み合わせることで、必ずしも確認アクションを必要としない軽微な推論になります。
予期しない住所コンポーネントが確認されていない。住所コンポーネントが未確認の場合、その住所のリスクレベルが高くなります。これにより、確認が必要になる場合があります。
確認済みである予期しない住所コンポーネント。このコンポーネントは厳密には適切な住所を必要としないため、Address Validation API は出力から削除します。書式設定の問題は通常、確認する必要はありません。

確認された軽微な推論

入力に次のタイプのコンポーネントが 1 つしかない場合でも、より詳細なレベルの確認データと組み合わせることで、API が正しい推論を行うことができます。

都市
状態
郵便番号
国

たとえば、顧客がマサチューセッツ州スプリングフィールドにある McDonald's レストランの有効な住所を入力したのに、都市名の入力を忘れて 4 桁の拡張子のない郵便番号を指定したとします。

住所を入力しました	地域
東京都港区六本木 6-10-1 01118	米国

「欠落している都市」の判定

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

Address Validation API が配達可能な住所を生成するために上位レベルのコンポーネントを推測する場合、システムからのデータが正しいという高い信頼性を得ることができます。これは、広い地理的リージョンを表す推定コンポーネントが、より細かい確認済み住所コンポーネントと照合されやすくなるためです。米国のスプリングフィールドのように都市名が繰り返されている国でも、他のコンポーネントを組み合わせて固有の住所を指定できます。

上記の例を使用すると、すべての住所コンポーネントをスキャンすると、すべてのコンポーネントが確認済みであること、つまり Address Validation API によって保存されたデータと一致し、サービスが 2 つの上位レベルのコンポーネントも推測していることがわかります。

{
  "componentName": {
    "text": "Springfield",
    "languageCode": "en"
  },
  "componentType": "locality",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
},
{
  "componentName": {
    "text": "1806"
  },
  "componentType": "postal_code_suffix",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
}

予期しない住所コンポーネントが確認されていません

このシナリオは、コンポーネントが確認されていない場合のチェックの重要性を示しています。想定外の住所コンポーネントがある場合、Address Validation API は出力から削除します。このような場合は、リスクレベルと信頼度に応じて、住所を受け入れるか、お客様に再確認できます。

たとえば、郵便機関に無視された無害な情報を顧客が入力することが多い地域の住所であれば、その住所を使用できます。ただし、未確認のコンポーネントがお客様の期待どおりに動作しないこともあります。

住所を入力しました	地域
1 Rue Grenache, la caritat 2, 34630 サンティベリー	フランス

予期しない住所コンポーネントの検証結果を確認できない

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

Address Validation API は、未確認のコンポーネントを含む判定結果に加えて、次の形式の住所を返します。

"formattedAddress": "1 Rue Grenache, 34630 Saint-Thibéry, France",

未確認のコンポーネントをスキャンすると、返された住所から API が la caritat 2 を削除したことがわかります。

{
  "componentName": {
    "text": "la caritat 2",
    "languageCode": "fr"
  },
  "componentType": "sublocality_level_1",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
  "unexpected": true
}

確認されている予期しない住所コンポーネント

この例では、住所に英国の郡が含まれていることが一般的です。ただし、これは英国の郵便局では要求されておらず、基本的に無視されます。postoffice.co.uk と英国および国際郵便の宛先の場合をご覧ください。

そのため、お客様が英国の住所の郡を指定すると、これを予期しない入力とみなします。

住所を入力しました	地域
33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP	英国

IS が確認された、想定外の住所コンポーネントに関する判定

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

ここで、address_complete は false と評価され、住所コンポーネントを分析すると予期しないフラグが明らかになります。

{
  "componentName": {
    "text": "Gloucestershire",
    "languageCode": "en"
  },
  "componentType": "administrative_area_level_2",
  "confirmationLevel": "CONFIRMED",
  "unexpected": true
}

入力された住所の正しい郡は「グロスターシャー」ですが、住所自体の形式は不適切です。Address Validation API では、情報の形式が適切かどうかも評価されることを思い出してください。