Address Validation API سرویسی است که یک آدرس را می پذیرد، اجزای آدرس را شناسایی می کند و آنها را تأیید می کند. همچنین آدرس پستی را استاندارد می کند و بهترین مکان lat/long را برای آن پیدا می کند. این می تواند به درک اینکه آیا یک آدرس به یک مکان واقعی اشاره دارد کمک کند. اگر آدرس به یک مکان واقعی اشاره نکند، میتواند اجزای احتمالاً اشتباه را شناسایی کند و کاربران را قادر میسازد تا آنها را تصحیح کنند.
Address Validation API ویژگی های بسیاری را برای کمک به پردازش یک آدرس ارائه می دهد، از جمله:
آدرس را به اجزای جداگانه آن جدا میکند و سپس بررسیهای اعتبارسنجی سطح مؤلفه، از جمله زیرمجموعهها (در صورت وجود) را ارائه میکند.
پاکسازی، استانداردسازی و استنتاج اجزای آدرس گمشده یا نادرست.
آدرس را با اطلاعات اضافی، از جمله ژئوکد، دقت آدرس، و داده های خدمات پستی تکمیل می کند.
یک رشته منفرد حاوی آدرس کامل که توسط API تعیین شده است را برمی گرداند.
نسخه ی نمایشی را امتحان کنید تا Address Validation API را در عمل ببینید.
Address Validation API را به گردش کار خود اضافه کنید
یکی از رایجترین موارد استفاده از Address Validation API این است که با اطمینان از ارائه آدرس صحیح مشتری، تجربه مشتری خود را ارتقا دهید. اعتبار سنجی آدرس با گرفتن آدرس های بد به کاهش خطاهای تحویل کمک می کند و با آگاهی بهتر از ویژگی های آدرس، قابلیت پیش بینی تحویل را بهبود می بخشد.
تصویر زیر فرم ساده ای را نشان می دهد که به مشتری امکان می دهد آدرسی را وارد کند، احتمالاً به عنوان بخشی از جریان پرداخت. این آدرس را به عنوان ورودی Address Validation API ارسال کنید.
در پاسخ خود، Address Validation API آدرس کاملی را که توسط API تعیین شده است برمی گرداند. آدرس کامل را به عنوان آدرس پیشنهادی به مشتری خود ارائه دهید:
اگر Address Validation API اطلاعات گم شده را تشخیص داد، از کاربر بخواهید آن را اضافه کند:
اگر API به دلیل گم شدن یا نادرست بودن اطلاعات نمی تواند آدرس ورودی را تأیید کند، از کاربر بخواهید آدرس را اصلاح کند:
تفاوت بین Address Validation API و Geocoding API
هم Geocoding API و هم Address Validation API سعی می کنند به این سوال پاسخ دهند که "بهترین مکان برای این ورودی کاربر چیست؟" برخلاف API Geocoding، Address Validation API همچنین تلاش میکند:
- به سوال "آیا این ورودی کاربر نشان دهنده یک آدرس واقعی است؟"
- آدرس ورودی را درک کنید حتی اگر قسمتهایی از آن را نتوان با دادههای موجود مطابقت داد
- ارائه بازخورد در مورد اعتبار اجزای مختلف
- بررسی کنید که آیا آدرس کامل است یا خیر و اجزای ضروری را که گم شده اند علامت گذاری کنید
- آدرس برگشتی را به طور خاص برای اهداف پستی قالب بندی کنید
برای مثال، با توجه به آدرسی مانند "123 Fake St, Mountain View, CA"، Geocoding API به سادگی یک ژئوکد برای شهر Mountain View، CA برمی گرداند و "123 Fake St" را نادیده می گیرد زیرا چنین خیابانی وجود ندارد (یا مشابه آن خیابان با نام) در Mountain View.
از سوی دیگر، Address Validation API میتواند تشخیص دهد که "123" یک شماره خیابان است، "Fake St" یک خیابان است، و نتیجهای را که حاوی آن مؤلفهها است برمیگرداند و آنها را بهعنوان تأیید نشده علامتگذاری میکند و به شما سیگنالی در مورد آن میدهد. چرا آدرس ممکن است در موقعیت جغرافیایی ناموفق باشد.
درباره CASS™
خدمات پستی ایالات متحده® (USPS®) 1 سیستم پشتیبانی دقت کدگذاری (CASS™) را برای پشتیبانی و تأیید ارائه دهندگان اعتبارسنجی آدرس حفظ می کند. یک سرویس CASS Certified™، مانند Address Validation API، به دلیل توانایی آن در پر کردن اطلاعات گم شده از یک آدرس، استاندارد کردن آن و به روز رسانی آن برای ارائه جدیدترین و دقیق ترین آدرس تأیید شده است.
CASS به طور پیش فرض فعال نیست و فقط برای مناطق "US" و "PR" پشتیبانی می شود. برای فعال کردن CASS، enableUspsCass
به عنوان بخشی از درخواست اعتبارسنجی روی true
تنظیم کنید. برای اطلاعات بیشتر، به تأیید اعتبار یک آدرس مراجعه کنید.
به عنوان بخشی از استفاده ما از خدمات USPS، USPS درخواستها را برای آدرسهای ایجاد شده مصنوعی ارزیابی میکند. اگر USPS تشخیص دهد که یک آدرس ورودی بهطور مصنوعی ایجاد شده است، Google موظف است اعتبار آدرسها را برای مشتری متوقف کند و باید اطلاعات تماس مشتری (نام و آدرس)، آدرس ورودی مربوطه، و دادههای استفاده جمعآوری شده را به USPS گزارش دهد. با استفاده از API با این شرایط خاص سرویس موافقت می کنید.
بعدش چی
- نسخه ی نمایشی را امتحان کنید
- سوالات متداول
- جزئیات پوشش کشور و منطقه
- در Cloud Console راه اندازی کنید
- یک کلید API دریافت کنید
- کتابخانه های مشتری
Google Maps Platform یک دارنده مجوز غیر انحصاری از US Postal Service® است. علامت(های) تجاری زیر متعلق به US Postal Service® است و با مجوز استفاده می شود: US Postal Service®، CASS™، CASS Certified™. ↩