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

هدف

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

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

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

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

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

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

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

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

برای آزمایش، حجم نمونه‌ای در حدود ۵۰۰۰ تا ۱۰۰۰۰ رکورد آماده کنید.

فراخوانی API

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

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

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

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

نتایج را بررسی کنید

پیش‌نیاز این بخش: درک نحوه مدیریت پاسخ اعتبارسنجی ، به ویژه مفهوم رفع، تأیید و پذیرش .

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

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

داده‌های پاسخ	چیست؟ (چیست؟)	چگونه ارزیابی کنیم	چگونه کمک می‌کند؟
حکم.ورودیجزئیات	جزئیات ورودی آدرس را توصیف می‌کند.	زیرفرضیه فرضیه مجاورت اولیه بلوک مسیر دیگر	به شما امکان می‌دهد تعیین کنید که آیا آدرس ورودی داده‌های کافی برای معتبر بودن دارد یا خیر.
حکم.اعتبارسنجیجزئیات	اعتبارسنجی کلی خروجی آدرس را شرح می‌دهد.	زیرفرضیه فرضیه مجاورت اولیه بلوک مسیر دیگر	به شما امکان می‌دهد کیفیت کلی آدرس را در خروجی از API تعیین کنید.
judge.hasInferredComponents	اگر API یک کامپوننت را استنباط کرده باشد، سیگنال می‌دهد.	درست/غلط	این API قادر است اجزای گمشده را در جایی که می‌تواند داده‌ها را استنباط کند، اضافه کند. برای مثال، یک کد وضعیت گمشده.
judge.hasReplacedComponents	اگر API یک کامپوننت را جایگزین کرده باشد، سیگنال می‌دهد.	درست/غلط	این API قادر است در برخی سناریوها اجزای نادرست را با داده‌های صحیح جایگزین کند.
حکم.آدرسکامل شد	اگر آدرس کامل باشد، سیگنال می‌دهد.	درست/غلط	اگر API تشخیص دهد که آدرس خروجی تمام اجزای لازم را دارد، این درست خواهد بود.
address.missingComponentTypes	سیگنالی برای هشدار در صورت عدم وجود اجزا در آدرس.	برای مقادیر به جدول دو مراجعه کنید .	اجزای گمشده را از یک آدرس ناقص برجسته کنید.

بررسی آدرس‌های معتبر

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

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

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

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

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

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

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

حکم

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

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

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

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

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

برای اطلاعات بیشتر به fix an address مراجعه کنید.

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

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

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

آدرس وارد شده	منطقه
خیابان چهلم، پلاک ۲۱، پلاک ۴۵	ایالات متحده آمریکا

حکم

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

بررسی اجزای مفقود یا تأیید نشده

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

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

مثال: کامپوننت مفقود و تأیید نشده

آدرس وارد شده	منطقه
خیابان فیک، نیویورک، نیویورک ۱۰۰۱۱	ایالات متحده آمریکا

حکم

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

اجزای مفقود و تأیید نشده

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

بررسی آدرس‌ها با اصلاحات

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

سیگنال‌های کلیدی که باید به دنبال آنها باشید عبارتند از:

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

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

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

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

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

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

addressComponent مسیر

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

[فقط آمریکا] بررسی آدرس با داده‌های ناقص یا نادرستِ محلِ فرعی

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

سیگنال‌های کلیدی که باید به دنبال آنها باشید عبارتند از:

• در شیء آدرس :
  • unconfirmedComponentTypes شامل subpremise است
  • missingComponentTypes شامل subpremise است
• در شیء UspsData :
  • dpvConfirmation برابر D است (فرضیه فرعی وجود ندارد)
  • dpvConfirmation برابر با S است (فرضیه فرعی تایید نشده است)

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

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

مثال: فرض فرعی مفقود شده

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

جزء گمشده

"missingComponentTypes": [
    "subpremise"
]

تأیید DPV داده‌های USPS

"dpvConfirmation": "D"

[فقط ایالات متحده] بررسی USPS standardizedAddress

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 اعتبارسنجی آدرس خود را امروز آغاز کنید تا از صحت داده‌های آدرس اطمینان حاصل کنید، تجربه مشتری را بهبود بخشید و عملیات تجاری خود را ساده کنید. پس از دنبال کردن سناریوهای آزمایشی ذکر شده در بالا، اطلاعات لازم را برای تعیین اینکه آیا API اعتبارسنجی آدرس برای گردش کار شما ارزشی به ارمغان می‌آورد یا خیر، خواهید داشت.

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

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

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

هنریک والو | مهندس DevX