اصلاح نشانی - مثال‌ها

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

نمونه‌های رایج: اصلاح

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

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

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

نشانی واردشده منطقه
21 45 40th street ایالات متحده آمریکا

رأی برای شهر و کد پستی ازقلم‌افتاده

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

{
  "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 برمی‌گرداند، با برخی حذفیات مهم در داده‌ها، مانند منطقه و کد پستی.

پلاک ثبت نشده است

این نمونه شماره خیابان ندارد.

نشانی واردشده منطقه
Buckingham Palace Road, SW1W 9TQ London بریتانیا
رأی برای شماره خیابان جاافتاده
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

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

"missingComponentTypes": [
        "street_number"
      ]

نمونه‌های موارد حاشیه‌ای: اصلاح

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

پلاک تأییدنشده

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

نشانی واردشده منطقه
84 Buckingham Palace Road, SW1W 9TQ, London بریتانیا

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

مثال زیر بر نشان‌های مهم تأکید می‌کند.

{
  "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 تنظیم شده است. تأییدنشده یعنی سرویس نمی‌تواند شماره خیابان ۸۴ را در مجموعه داده‌هایش مطابقت دهد، و محتمل یعنی داده‌های مؤلفه همچنان می‌تواند معتبر باشد.

زیرمکان وجود ندارد

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

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

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

رأی برای زیرمکان ناموجود

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

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

}

پُرسمان address موارد زیر را نشان می‌دهد:

"missingComponentTypes": [
        "subpremise"
      ]

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