Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

住所の確認 - 例

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

一般的な例: 確認

次の例は、街路名が似ている大都市圏のケースを示しています。ユーザーが米国ワシントン州カークランドの Google Building 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ほど詳細ではありません。レスポンスには、未確認のコンポーネントと置き換えられたコンポーネントの両方が含まれているため、組み合わせによって確認カテゴリに分類されます。

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

{
  "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と英国および海外の郵便物の宛先をご覧ください。

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

入力した住所	リージョン
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 は、適切な形式の情報も評価します。