راه حل اعتبار سنجی آدرس را انتخاب کنید

هدف

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

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

اهداف این آزمون عبارتند از:

1. تأیید کنید Address Validation API برای مورد استفاده شما مناسب است.
2. بررسی کنید که چگونه Address Validation API الزامات راه حل های شما را برآورده می کند، مانند:
   • شناسایی آدرس های با کیفیت خوب
   • هشدار برای رسیدگی به ورودی هایی که کیفیت پایینی دارند.
   • انجام اصلاحات برای آدرس دادن به داده ها، از جمله استنتاج، جایگزینی، و تصحیح املا.
   • ارائه یک آدرس فرمت شده برای حمل و نقل.
   • هشدار در مورد داده های فرعی گم شده یا نادرست (فقط ایالات متحده).
3. اطمینان حاصل کنید که از اجرای API سود قابل اندازه گیری دریافت خواهید کرد.

پس از انجام تست، می‌توانید به سؤالات بالا پاسخ دهید و تعیین کنید که آیا API مناسب برای تجارت شما است یا خیر.

داده های خود را آماده کنید

آزمایش شما باید با نمونه ای از داده های آدرس موجود شما انجام شود. داده‌ها را برای آزمایش انتخاب نکنید، بلکه نمونه‌های تصادفی را انتخاب کنید که معرف جغرافیایی است که در آن فعالیت می‌کنید. این بدان معناست که اگر در ایالات متحده و بریتانیا فعالیت می‌کنید، اما 70 درصد از کسب و کار شما در بریتانیا انجام می‌شود در مقابل 30 درصد در ایالات متحده، نمونه باید منعکس‌کننده این تقسیم‌بندی باشد.

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

اندازه نمونه حدود 5000 تا 10000 رکورد برای آزمون آماده کنید.

با API تماس بگیرید

پیش نیاز بخش: نحوه ارسال درخواست اعتبار سنجی آدرس را بدانید.

هنگامی که داده ها را آماده کردید، باید هر رکورد آدرس را در برابر API اجرا کنید.

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

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

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

پیش نیاز بخش: نحوه مدیریت پاسخ اعتبار سنجی ، به ویژه مفهوم Fix، Confirm و Accept را بدانید.

در این بخش، سناریوهای خروجی را که ممکن است برای ارزیابی تناسب راه حل تحلیل کنید، مورد بحث قرار خواهیم داد.

مروری بر فیلدهای کلیدی API مورد بحث در این سند

داده های پاسخ	چیست؟	چگونه ارزیابی کنیم	چگونه کمک می کند؟
verdict.inputGranularity	جزئیات ورودی آدرس را توصیف می کند.	SUB_PREMISE مقدمه PREMISE_PROXIMITY BLOCK مسیر دیگر	به شما امکان می‌دهد تعیین کنید آیا آدرس ورودی داده‌های کافی برای معتبر بودن بالقوه دارد یا خیر.
verdict.validationGranularity	اعتبار سنجی خروجی کلی آدرس را شرح می دهد.	SUB_PREMISE مقدمه PREMISE_PROXIMITY BLOCK مسیر دیگر	به شما امکان می دهد کیفیت کلی آدرس را در خروجی از API تعیین کنید.
verdict.hasInferredComponents	اگر API یک مؤلفه را استنباط کرده باشد، سیگنال می دهد.	درست / نادرست	API قادر است اجزای گمشده را اضافه کند تا بتواند داده ها را استنتاج کند. به عنوان مثال، یک کد دولتی گم شده است.
verdict.hasReplacedComponents	اگر API جایگزین یک جزء شده باشد، سیگنال می دهد.	درست / نادرست	API قادر است اجزای نادرست را با داده های صحیح در برخی سناریوها جایگزین کند.
verdict.addressComplete	اگر آدرس کامل باشد، سیگنال می دهد.	درست / نادرست	اگر API مشخص کند که آدرس خروجی همه اجزای لازم را دارد، این درست خواهد بود.
address.missingComponentTypes	سیگنالی برای هشدار در صورت عدم وجود اجزای آدرس.	برای مقادیر به جدول دو مراجعه کنید .	اجزای گم شده را از یک آدرس ناقص برجسته کنید.

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

داده های برگردانده شده از API را مرتب کنید تا مجموعه آدرس هایی را که سیستم شما به عنوان معتبر می پذیرد، مشخص کنید. سیگنال های کلیدی که باید از API جستجو کنید عبارتند از:

• verdict.validationGranularity حاوی PREMISE یا بهتر است.
• verdict.addressComplete true است.
• هیچ جزء استنباط شده یا جایگزینی وجود ندارد.

برای اطلاعات بیشتر به آدرس پذیرش مراجعه کنید.

خروجی این تمرین باید زیرمجموعه ای از داده های آدرس باشد که توسط سیستم شما به عنوان معتبر پذیرفته می شود. در این مرحله می توانید تعیین کنید:

• آیا درصد قبولی قابل قبول است؟
• اگر از یک گردش کار اعتبارسنجی آدرس موجود استفاده می کنید، نرخ پذیرش معادل است یا بهتر؟

مثال: آدرس معتبر

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

حکم

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

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

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

برای تعیین مجموعه آدرس هایی که سیستم شما به عنوان نامعتبر علامت گذاری می کند، داده های برگشتی را از API مرتب کنید. سیگنال های کلیدی که باید از API جستجو کنید عبارتند از:

• verdict.validationGranularity بسته به سطح خطر شما روی OTHER یا ROUTE تنظیم شده است.
• verdict.addressComplete false است.

برای اطلاعات بیشتر به رفع آدرس مراجعه کنید.

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

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

مثال: آدرس نامعتبر است

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

حکم

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

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

در این مرحله، اجزای گم شده یا تایید نشده نیز قابل بررسی هستند. این بخشی از شیء Address در بازگشت است. دو فیلد missingComponentTypes و unconfirmedComponentTypes هستند.

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

مثال: مؤلفه گمشده و تأیید نشده

آدرس وارد شد	منطقه
خیابان جعلی، نیویورک، نیویورک 10011	ایالات متحده آمریکا

حکم

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

اجزای گم شده و تایید نشده

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

آدرس ها را با اصلاحات مرور کنید

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

سیگنال های کلیدی برای جستجو عبارتند از:

• inferred ، replaced ، یا spellCorrected در هر یک از addressComponents روی true تنظیم شده است.
• verdict.hasInferredComponents یا verdict.hasReplacedComponents روی true تنظیم شده است.

برای اطلاعات بیشتر به تأیید یک آدرس مراجعه کنید.

خروجی این تمرین باید زیرمجموعه ای از داده های آدرسی باشد که توسط API اصلاح شده است.

بخشی از این داده ها را می توان به صورت دستی بازبینی کرد تا مشخص شود آیا API در حال انجام اصلاحاتی در داده های شما است که اصطکاک را در جریان کار پایین دست شما کاهش می دهد.

مثال: آدرس با تصحیح

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

addressComponent مسیر

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[فقط ایالات متحده] آدرس را با داده های فرعی گم شده یا نادرست مرور کنید

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

سیگنال های کلیدی برای جستجو عبارتند از:

• در شیء Address :
  • unconfirmedComponentTypes حاوی subpremise است
  • missingComponentTypes حاوی subpremise است
• در شی UspsData :
  • dpvConfirmation D است (فرعی وجود ندارد)
  • dpvConfirmation S است (فرعی تایید نشده)

برای اطلاعات بیشتر به آدرس های ایالات متحده مراجعه کنید.

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

مثال: فرض فرعی وجود ندارد

آدرس وارد شد	منطقه
111 8th Avenue, Manhattan, NY 10011	ایالات متحده

جزء گم شده

"missingComponentTypes": [
    "subpremise"
]

تایید DPV داده های USPS

"dpvConfirmation": "D"

[فقط ایالات متحده] USPS standardizedAddress را مرور کنید

Address Validation API همچنین آدرس استاندارد USPS را برای آدرس های ایالات متحده برمی گرداند. این امر به ویژه در صورتی مهم است که نیاز دارید آدرس های فرمت شده USPS روی برچسب های حمل و نقل شما چاپ شود.

UspsAddress را می توان برای مشاهده این داده ها بازبینی کرد و تعیین کرد که آیا ارزشی به گردش کار شما اضافه می کند یا خیر.

مثال: آدرس استاندارد USPS

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

نتیجه گیری

آزمایش را شروع کنید - برای اطمینان از داده‌های آدرس دقیق، بهبود تجربه مشتری و ساده‌سازی عملیات کسب‌وکارتان، آزمایش API اعتبارسنجی آدرس خود را از امروز آغاز کنید. پس از پیروی از سناریوهای آزمایشی ذکر شده در بالا، اطلاعاتی را که برای تعیین اینکه آیا Address Validation API ارزشی برای گردش کار شما ایجاد می‌کند یا خیر، در اختیار خواهید داشت.

پیشنهاد مطالعه بیشتر:

• اسناد توسعه دهنده Address Validation API
• از Address Validation API برای پردازش آدرس ها با حجم بالا استفاده کنید
• اعتبار سنجی آدرس برای تسویه حساب تجارت الکترونیک

مشارکت کنندگان

Henrik Valve | مهندس DevX