آدرس را ثابت کنید - نمونه ها

این سند تعدادی از سناریوهای دنیای واقعی را توصیف می‌کند که در آن Address Validation API سیگنال‌های پاسخی را ارائه می‌دهد که رفتار اصلاحی سیستم شما را تضمین می‌کند. نمای کلی گردش کار را در Build your validation logic for context ببینید.

مثال های رایج: رفع

این بخش نمونه‌های رایجی را توضیح می‌دهد که در آن Address Validation API سیگنال‌های پاسخی را ارائه می‌کند که اطلاعات آدرس با کیفیت پایین‌تری را نشان می‌دهد.

شهر و کد پستی موجود نیست

این مثال یک ورودی را نشان می‌دهد که فقط آدرس خیابان دارد، بدون شهر یا کد پستی.

آدرس وارد شد منطقه
خیابان 40 21 45 ایالات متحده آمریکا

حکم مفقود شدن شهر و کد پستی

مثال زیر بر سیگنال های مهم از پاسخ تاکید می کند.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

این سیگنال‌ها نشان‌دهنده یک آدرس غیرقابل تحویل هستند، بنابراین برای کسب اطلاعات بیشتر می‌توانید addressComponents جستجو کنید:

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

Address Validation API فقط کشور (ایالات متحده) را به عنوان CONFIRMED برمی گرداند. همه اجزای آدرس دیگر را به‌عنوان UNCONFIRMED_BUT_PLAUSIBLE ، با برخی حذفیات مهم در داده‌ها، مانند محل و کد پستی، برمی‌گرداند.

شماره خیابان گم شده است

این مثال یک شماره خیابان گم شده را نشان می دهد.

آدرس وارد شد منطقه
جاده کاخ باکینگهام، SW1W 9TQ لندن انگلستان
حکم برای گم شدن شماره خیابان 
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity ROUTE است که نشان‌دهنده تطابق با خیابان است، اما اطلاعات کافی برای رسیدن به محل وجود ندارد. علاوه بر این، ویژگی addressComplete در حکم وجود ندارد و بنابراین false است. یک پرس و جو بیشتر از شی address یک نوع مؤلفه گمشده را نشان می دهد:

"missingComponentTypes": [
        "street_number"
      ]

مثال‌های حاشیه‌ای: تعمیر

در برخی شرایط، اینکه آیا آدرسی را تصحیح، تأیید یا قبول می کنید، به سناریوی تجاری خاص شما بستگی دارد. مثال‌های زیر سناریوهایی را نشان می‌دهند که ممکن است به شدت در یک دسته تعمیر قرار نگیرند.

شماره خیابان تایید نشده

در این سناریو، Address Validation API نمی تواند شماره خیابان ارائه شده را تأیید کند، اما نشان می دهد که آدرس کامل است.

آدرس وارد شد منطقه
84 جاده کاخ باکینگهام، SW1W 9TQ، لندن انگلستان

حکم برای شماره خیابان تایید نشده

مثال زیر بر سیگنال های مهم تاکید دارد.

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

ارزش بررسی ترکیبی از یک ریزه کاری اعتبارسنجی را فقط برای تقریب در سطح مقدماتی همراه با مؤلفه های تأیید نشده دارد. یک پرس و جو از ویژگی addressComponents componentType تایید نشده زیر را نشان می دهد:

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

در اینجا، confirmation_level street_number روی UNCONFIRMED_BUT_PLAUSIBLE تنظیم شده است. تأیید نشده به این معنی است که سرویس نمی تواند با شماره خیابان 84 در مجموعه داده خود مطابقت داشته باشد، و قابل قبول به این معنی است که داده های مؤلفه هنوز می توانند معتبر باشند.

فرض فرعی وجود ندارد

این سناریو آدرسی را توصیف می‌کند که فقط یک فرض فرعی مانند یک آپارتمان یا شماره بخش وجود ندارد. در غیر این صورت، Address Validation API می تواند آدرس را به طور کامل تأیید کند. همانطور که در مواردی که هر جزء آدرسی وجود ندارد، addressComplete false است و بنابراین در بازرسی دستی حکم وجود ندارد.

برای مثال، فرض کنید مشتری یک آدرس معتبر برای دفتر ارزیاب شهر سانفرانسیسکو وارد کرده است، اما شماره اتاق را از ورودی نادیده می گیرد.

آدرس وارد شد منطقه
1 Doctor Carlton B Goodlett Place، سانفرانسیسکو، CA 94102 ایالات متحده آمریکا

حکم برای از دست دادن فرض فرعی

در این مثال، حکم خاصیت addressComplete را نمایش نمی‌دهد، بنابراین false است. به همین دلیل، می دانید که حداقل یک عنصر آدرس غیرمنتظره، حل نشده یا گم شده است.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true

}

یک پرس و جو address موارد زیر را نشان می دهد:

"missingComponentTypes": [
        "subpremise"
      ]

پس از بررسی بیشتر، داده‌های USPS یک کد dpvConfirmation از D را ارائه می‌دهند، که همچنین نشان‌دهنده یک فرض فرعی است.