این سند تعدادی از سناریوهای دنیای واقعی را شرح می‌دهد که در آن‌ها Address Validation API سیگنال‌های پاسخی ارائه می‌دهد که رفتار افزودن زیرمجموعه را از سیستم شما تضمین می‌کند. این نشان‌ها فقط برای نشانی‌های ایالات متحده دردسترس است. برای بافت، نمونه گردش‌های کاری را در ساختن منطق اعتبارسنجی ببینید.
نمونه رایج: افزودن زیرمکان
این سناریو نشانی‌ای را نشان می‌دهد که در آن سیستم شما ممکن است از مشتری بخواهد شماره واحد را به نشانی اضافه کند.
| نشانی واردشده | منطقه |
|---|---|
| 1450 Brickell Avenue, Miami, FL 33131-4065 | ایالات متحده |
رأی برای نشانی‌ای که زیرمجموعه ندارد
مثال زیر سیگنال مهم را برجسته می‌کند.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}
نمونه مورد لبه‌ای: افزودن زیرمکان‌ها
مثال زیر موقعیتی را پوشش می‌دهد که در آن verdict نشان‌دهنده
مشکلات کیفیت نشانی است که نیاز به بررسی بیشتر دارد. این مثال همچنین نشان می‌دهد که چگونه منطق شما می‌تواند از رأی به مؤلفه‌های نشانی منتقل شود تا تصویر کامل‌تری برای بهبود منطق سیستم شما به‌دست آید.
زیرمکان‌ها و مؤلفه‌های استنباط‌شده و جایگزین‌شده وجود ندارد
این مثال ورودی نشانی ایالات متحده را با منطقه مفقود و کد پستی نادرست نشان می‌دهد.
| نشانی واردشده | منطقه |
|---|---|
| 1450 Brickell Avenue, FL 33132-4065 | ایالات متحده |
حکم برای پیش‌فرض‌های فرعی مفقود و مؤلفه‌های استنباط‌شده و جایگزین‌شده
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true,
"hasReplacedComponents": true,
"possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}
بررسی بیشتر اجزای نشانی نشان می‌دهد که منطقه استنباط شده است و کد پستی جایگزین شده است.
{
"componentName": {
"text": "33131",
}
"componentType": "postal_code",
"confirmationLevel": "CONFIRMED",
"replaced": true
},
{
"componentName": {
"text": "Miami",
"languageCode": "en"
}
"componentType": "locality",
"confirmationLevel": "CONFIRMED",
"inferred": true
}