این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

آدرس را قبول کنید - نمونه ها

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

مثال رایج: قبول

این سناریو آدرسی را نشان می دهد که در آن سیستم شما آدرس وارد شده توسط مشتری را می پذیرد.

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

حکم برای یک آدرس قابل قبول

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

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

علاوه بر این، پاسخ موارد زیر را نشان می دهد:

hasUnconfirmedComponents false باقی می ماند
hasInferredComponents false باقی می ماند
hasReplacedComponents false باقی می ماند

هنگامی که این سیگنال ها با هم ترکیب می شوند، نشان دهنده یک آدرس با کیفیت بالا هستند.

مثال های مورد لبه: قبول

مثال‌های زیر موقعیت‌هایی را پوشش می‌دهند که در آن verdict نشان‌دهنده رسیدگی به مسائل کیفی است که تحقیقات بیشتر را ایجاب می‌کند. این مثال‌ها همچنین نشان می‌دهند که چگونه منطق شما می‌تواند از حکم به اجزای آدرس سفر کند تا تصویر کامل‌تری به‌منظور ارتقای منطق سیستم شما به دست آورد.

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

این مثال ورود یک آدرس ایتالیایی را با تمام اجزای آدرس، به همراه هیچ مؤلفه استنباط‌شده یا جایگزینی نشان می‌دهد. با این حال، validationGranularity ROUTE است.

آدرس وارد شد	منطقه
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia	IT

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

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

بررسی بیشتر اجزای آدرس نشان می دهد که شماره خیابان UNCONFIRMED_BUT_PLAUSIBLE است.

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

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

این مثال، ورود یک آدرس ایالات متحده را با تمام اجزای آدرس، بدون اجزای استنباط شده یا جایگزین شده نشان می دهد. با این حال، validationGranularity PREMISE_PROXIMITY است.

آدرس وارد شد	منطقه
975 Carson Dr, Sunnyvale, CA 94086	ایالات متحده

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

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

اقدام: رفع. این مثال مشابه نمونه قبلی است و آدرس را می توان به عنوان وارد شده پذیرفت. با این حال، کد dpvConfirmation اضافی N یک سیگنال قوی برای تأیید آدرس با مشتری ارائه می دهد یا از آنها می خواهد آن را تعمیر کنند. رفتاری که برای این مورد انتخاب می کنید در نهایت به سطح اطمینان مورد نیاز شما بستگی دارد. برای جزئیات بیشتر، راهنمای پیاده‌سازی را در Build your validation logic ببینید.

داده های USPS ناقص برای یک آدرس تایید شده

این مثال ورود یک آدرس ایالات متحده را با تمام اجزای آدرس تایید شده، بدون اجزای استنباط شده یا جایگزین شده، و یک validationGranularity of PREMISE را نشان می دهد. با این حال، uspsData به طور کامل پر نشده است و حاوی مقدار dpvConfirmation نیست.

آدرس وارد شد	منطقه
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703	ایالات متحده

حکم برای یک آدرس تایید شده با داده های ناقص USPS

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

داده‌های USPS برای یک آدرس تأیید شده با داده‌های USPS ناقص

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}

عمل: قبول. حتی اگر آدرس DPV توسط USPS تایید نشده باشد، validationGranularity PREMISE سیگنال قوی می دهد که این یک آدرس معتبر است. با این حال، برای اطمینان بیشتر، می توانید از مشتری بخواهید آدرس را تأیید کند. برای جزئیات بیشتر، راهنمای پیاده‌سازی را در Build your validation logic ببینید.