بررسی اجمالی اعتبار سنجی آدرس

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

چرا از اعتبارسنجی آدرس در API جاوا اسکریپت نقشه استفاده کنیم؟

کتابخانه اعتبارسنجی آدرس، یک آدرس را به عنوان ورودی دریافت می‌کند تا اجزای آدرس را شناسایی و اعتبارسنجی کند. همچنین آدرس را برای ارسال پستی استانداردسازی کرده و بهترین مختصات طول/عرض جغرافیایی شناخته شده را برای آن پیدا می‌کند. به صورت اختیاری، برای آدرس‌های ایالات متحده و پورتوریکو، می‌توانید سیستم پشتیبانی دقت کدگذاری (CASS™) را فعال کنید.

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

کارهایی که می‌توانید با اعتبارسنجی آدرس در API جاوا اسکریپت نقشه انجام دهید

با اعتبارسنجی آدرس در Maps JavaScript API، می‌توانید تعیین کنید که آیا یک آدرس به یک مکان واقعی اشاره دارد یا خیر. اگر آدرس به یک مکان واقعی اشاره نداشته باشد، API می‌تواند اجزای احتمالاً اشتباه را شناسایی کند که می‌توانید برای اصلاح به مشتریان خود ارائه دهید. در اینجا یک نمونه گردش کار آمده است:

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

    آدرسی که مشتری وارد کرده است.

  2. برنامه آدرس را به API ارسال می‌کند - برنامه این آدرس را با استفاده از متد fetchAddressValidation ارسال می‌کند.

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

  4. مشتری آدرس را تأیید یا تصحیح می‌کند — بسته به آنچه API برمی‌گرداند، می‌توانید پیام‌های زیر را به مشتری ارائه دهید:

    1. آدرس پیشنهادی را تأیید کنید.
    2. اطلاعات ناقص را ارائه دهید.
    3. آدرس رو درست کن.
    مشتری می‌تواند آدرس اصلاح‌شده را تأیید کند.مشتری می‌تواند اطلاعات ناقص خود را ارائه دهد.مشتری می‌تواند آدرس را اصلاح کند.

نحوه‌ی عملکرد اعتبارسنجی آدرس در API جاوا اسکریپت نقشه‌ها

وقتی فراخوانی fetchAddressValidation انجام می‌شود، API موارد زیر را امتحان می‌کند:

  • تصحیح می‌کند — بررسی‌های اعتبارسنجی در سطح مؤلفه، از جمله در صورت وجود، برای زیرمحوطه‌ها را ارائه می‌دهد.
  • تکمیل می‌کند - تلاش می‌کند تا اجزای آدرس گم‌شده یا نادرست را استنباط کند.
  • قالب‌ها - قالب اجزای آدرس را پاک‌سازی و استاندارد می‌کند.

درباره CASS™

سرویس پستی ایالات متحده (USPS®) 1 از سیستم پشتیبانی دقت کدگذاری (CASS™) برای پشتیبانی و تأیید ارائه‌دهندگان اعتبارسنجی آدرس استفاده می‌کند. یک سرویس CASS Certified™، مانند API اعتبارسنجی آدرس، به دلیل توانایی‌اش در پر کردن اطلاعات از دست رفته در یک آدرس، استانداردسازی آن و به‌روزرسانی آن برای ارائه جدیدترین و دقیق‌ترین آدرس، تأیید شده است.

CASS به طور پیش‌فرض فعال نیست و فقط برای مناطق "US" و "PR" پشتیبانی می‌شود. برای فعال کردن CASS، به عنوان بخشی از درخواست اعتبارسنجی، `enableUspsCass` را روی `true` تنظیم کنید. برای اطلاعات بیشتر، به Validate an address مراجعه کنید.

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

مراحل بعدی

  1. پلتفرم نقشه‌های گوگل (Google Maps Platform) دارای مجوز غیر انحصاری از خدمات پستی ایالات متحده (United States Postal Service®) است. علامت تجاری(های) زیر متعلق به خدمات پستی ایالات متحده (United States Postal Service®) هستند و با اجازه استفاده می‌شوند: خدمات پستی ایالات متحده (United States Postal Service®)، CASS™، CASS Certified™. ↩