Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

住所の確認 - 例

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

一般的な例: 確認

次の例は、類似した道路名を持つ大都市圏のケースを示しています。たとえば、ユーザーが Google Building D in Kirkland, WA, United States の住所を入力しようとしているとします。ただし、都市として「Kirkland」ではなく、誤って「Seattle」と入力します。

住所を入力しました	リージョン
Building D, 451 7th Avenue South, Seattle, WA 98033	米国

置換されたデータの判定

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

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

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

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

{
  "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 は、提供された住所にシアトルで近い住所を見つけ、上位レベルのコンポーネントである郵便番号を置き換えて、シアトルの住所に解決しました。これは有効な置換である可能性がありますが、コンポーネントが未確認であるという事実とともに、ユーザーが Kirkland などの別の住所ではなく、Seattle の住所を入力する意図があることを確認することは理にかなっています。

エッジケースの例: 確認

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

確認済みの未成年者に関する推測。 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 と英国および国際郵便の宛先の書き方をご覧ください。

その結果、お客様が英国の住所に郡を指定すると、サービスはこれを予期しない入力として評価します。

住所を入力しました	リージョン
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
}

Gloucestershire は入力された住所の正しい郡ですが、住所自体の形式が正しくありません。Address Validation API は、適切な形式の情報も評価します。