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

住所の確認 - 例

このドキュメントでは、Address Validation API が、システムで確認動作が必要となる住所のレスポンスシグナルを提供する、実際のシナリオをいくつか説明します。以下の例は説明のためのものであり、すべてを網羅しているわけではありません。コンテキストについては、検証ロジックを構築するのワークフローの概要をご覧ください。

一般的な例: 確認

次の例は、似たような道路名がある都市部の場合を示しています。たとえば、ユーザーが米国ワシントン州カークランドの Google Building D の住所を入力しようとしているとします。しかし、都市として Kirkland ではなく、誤って Seattle と入力してしまいます。

住所を入力済み	地域
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 は正しい推論を行うことができます。

市区町村
州
郵便番号
国

たとえば、マサチューセッツ州スプリングフィールドにあるマクドナルドの有効な番地を入力したものの、市町村の入力を忘れて、4 桁の拡張子なしで郵便番号を入力したお客様がいます。

住所を入力済み	地域
1402 Allen St, MA 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 Saint-Thibéry	フランス

予期しない住所コンポーネントが確認されていない場合の判定

{
  "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 と How to address UK and international mail をご覧ください。

そのため、英国の住所で郡が指定されている場合、サービスはこれを予期しない入力として評価します。

住所を入力済み	地域
33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP	英国

確認済みの予期しない住所コンポーネントの判定

{
   "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 は、適切な形式の情報も評価します。