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

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

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

کتابخانه «اعتبارسنجی نشانی» نشانی را به‌عنوان ورودی دریافت می‌کند تا مؤلفه‌های نشانی را شناسایی و اعتبارسنجی کند. همچنین نشانی را برای ارسال پستی استاندارد می‌کند و بهترین مختصات شناخته‌شده عرض جغرافیایی/طول جغرافیایی را برای آن پیدا می‌کند. اختیاراً، برای نشانی‌های ایالات متحده و پورتوریکو، می‌توانید Coding Accuracy Support System (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™‎

The United States Postal Service® (USPS®)1 maintains the Coding Accuracy Support System (CASS™) to support and certify address validation providers. یک سرویس 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™‎. ↩