このドキュメントでは、Address Validation API が、システムからの確認動作を保証する住所のレスポンス シグナルを提供する実際のシナリオをいくつか説明します。詳細については、検証ロジックを構築するのワーク��ローの概要をご覧ください。
一般的な例: 確認
次の例は、類似した街名を持つ大都市圏の例を示しています。ユーザーが米国ワシントン州カークランドにある Google Building D の住所を入力するとします。しかし、都市として Kirkland ではなく、誤ってシアトルに入ります。
入力された住所 | 地域 |
---|---|
ビル D, 451 7th Avenue South, シアトル, 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 桁の拡張子のない郵便番号を指定したとします。
入力された住所 | 地域 |
---|---|
〒 101-0054 東京都千代田区神田錦町 3-22 | 米国 |
地図に載っていない都市の判定
{
"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",
未確認のコンポーネントのスキャンでは、返された住所から 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、チェルトナム、グロスターシャー��GL50 4AP | UK |
確認されている予期しない住所コンポーネントの判定結果
{
"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 は情報が正しい形式かどうかも評価します。