نمای کلی اعتبارسنجی نشانی

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

چرا باید از «اعتبارسنجی نشانی» در Maps JavaScript API استفاده کرد؟

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

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

کارهایی که می‌توانید با «اعتبارسنجی نشانی» در Maps JavaScript API انجام دهید

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

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

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

  2. برنامه نشانی را به میانای برنامه‌سازی کاربردی ارسال می‌کند — برنامه این نشانی را بااستفاده از روش fetchAddressValidation ارسال می‌کند.

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

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

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

نحوه عملکرد «اعتبارسنجی نشانی» در Maps JavaScript API

وقتی تماسی با fetchAddressValidation برقرار می‌شود، میانای برنامه‌سازی کاربردی موارد زیر را امتحان می‌کند:

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

درباره CASS™

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

CASS به‌طور پیش‌فرض فعال نیست و فقط برای مناطق «ایالات متحده» و «پورتوریکو» پشتیبانی می‌شود. برای فعال کردن CASS،‏ `enableUspsCass` را به‌عنوان بخشی از درخواست اعتبارسنجی روی `true` تنظیم کنید. برای اطلاعات بیشتر، اعتبارسنجی نشانی را ببینید.

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

مراحل بعدی

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