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

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

مقدمه

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

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

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

ملاحظات دیگر

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

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

API مربوط به Geocoding نسخه ۴، متد SearchDestinations را معرفی می‌کند که مختصات ورودی ساختمان‌ها، نقاط ناوبری و خطوط خارجی ساختمان را برمی‌گرداند. برای جزئیات بیشتر به بخش جستجوی مقصدها در API مربوط به Gecoding نسخه ۴ مراجعه کنید.

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

نسخه آزمایشی را امتحان کنید

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

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

  2. برنامه آدرس را به API ارسال می‌کند - برنامه این آدرس را به عنوان ورودی به API اعتبارسنجی آدرس ارسال می‌کند.

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

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

  4. مشتری آدرس را تأیید یا اصلاح می‌کند – بسته به آنچه API برمی‌گرداند، می‌توانید پیام‌های زیر را به مشتری ارائه دهید: الف. آدرس پیشنهادی را تأیید کنید. ب. اطلاعات ناقص را ارائه دهید. ج. آدرس را اصلاح کنید.

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

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

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

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

منابع

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

منابع داده داده‌ها بازگردانده شدند

آدرس کامپوننت‌ها در قالب JSON.

به اعتبارسنجی آدرس مراجعه کنید.

آدرس کامل و معتبر (در صورت امکان).

وضعیت اعتبارسنجی هر جزء آدرس.

آدرس در چه مواردی موجود است:

  • ژئوکد
  • دقت آدرس
  • داده‌های خدمات پستی، در صورت وجود.

به بخش «درک پاسخ اعتبارسنجی» مراجعه کنید.

نحوه استفاده از API اعتبارسنجی آدرس

۱ نسخه آزمایشی را امتحان کنید نسخه آزمایشی را با انواع اشکال آدرس، چه صحیح و چه نادرست، بررسی کنید . این نسخه آزمایشی روشی مفید برای بررسی مقادیر بازگشتی از سرویس و همچنین پاسخ API با فرمت JSON ارائه می‌دهد.
۲ پوشش را بررسی کنید جزئیات پوشش را بررسی کنید تا ببینید API اعتبارسنجی آدرس از کدام کشورها و مناطق پشتیبانی می‌کند.
۳ راه‌اندازی شوید با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های بعدی را تکمیل کنید.
۴ درخواست اعتبارسنجی آدرس با یک آدرس پایه شروع کنید و سپس، برای دقت بیشتر، می‌توانید CASS را فعال کنید (فقط برای آدرس‌های ایالات متحده و PR). به درخواست اعتبارسنجی آدرس مراجعه کنید.
۵ پردازش یک پاسخ پاسخ API اعتبارسنجی آدرس دو ویژگی ارائه می‌دهد که هر کدام از آنها به روش‌های مختلفی استفاده می‌شوند. برای درک یک پاسخ پایه به این لینک مراجعه کنید.
۶ بهبود دقت اعتبارسنجی شما می‌توانید با ارائه بازخورد در مورد پاسخ‌های API اعتبارسنجی آدرس، به بهبود دقت آدرس کمک کنید. به بخش مدیریت آدرس‌های به‌روزرسانی‌شده مراجعه کنید.

کتابخانه‌های کلاینت موجود

برای فهرستی از کتابخانه‌های کلاینت موجود برای 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™. ↩