مرجع سریع Address Validation API

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

Address Validation API: حقایق کلیدی

  • محصول: Address Validation API
  • دسته: مکان‌ها
  • پلاتفرم: سرویس وب (REST)
  • اجرا در: سرور (کد پسین)
  • مرحله راه‌اندازی: GA
  • چرخه حیات: فعال
  • نمای کلی: نمای کلی Address Validation API
  • دردسترس بودن منطقه‌ای: محدود. کشورهای پشتیبانی‌شده و کیفیت داده‌ها بسته به کشور متفاوت است و برخی کشورها در مرحله «پیش‌نمایش» هستند. فراداده‌های مسکونی و تجاری فقط برای کشورهایی که در صفحه پوشش پرچم‌گذاری شده‌اند برگردانده می‌شود. USPS CASS فقط برای ایالات متحده و پورتوریکو پشتیبانی می‌شود. (جزئیات پوشش)

Address Validation API: زمان استفاده از آن

در موارد زیر از Address Validation API استفاده کنید:

  • باید بررسی کنید که آیا نشانی به مکانی واقعی اشاره دارد یا نه و ببینید کدام مؤلفه‌ها وجود ندارد یا احتمالاً اشتباه است.
  • باید نشانی را برای ارسال پستی استانداردسازی و تکمیل کنید، مثلاً درطول روند تسویه‌حساب.
  • برای نشانی‌های ایالات متحده یا پورتوریکو، به اعتبارسنجی گواهی‌شده USPS CASS و uspsData نیاز دارید.
  • به فراداده نشانی مسکونی یا تجاری برای کشوری که در صفحه پوشش فهرست شده است نیاز دارید.

در موارد زیر از Address Validation API استفاده نکنید:

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

Address Validation API: setup

بسته‌های رسمی Address Validation API:

  • npm: @googlemaps/addressvalidation
  • pypi: google-maps-addressvalidation
  • برو: cloud.google.com/go/maps

Address Validation API: common mistakes

  • مشکل: وقتی مقدار ویژگی addressComplete برابر با false باشد، این ویژگی از رأی حذف می‌شود، بنابراین کدی که انتظار دارد این فیلد وجود داشته باشد ممکن است نشانی‌های ناقص را اشتباه بخواند. اصلاح: با ویژگی addressComplete جاافتاده به‌عنوان false رفتار کنید، یا وجود ویژگی را بررسی کنید. /maps/documentation/address-validation/understand-response را ببینید.
  • مشکل: اگر regionCode حذف شود، API منطقه را از نشانی استنباط می‌کند که می‌تواند نتایج ضعیف‌تری ارائه دهد. اصلاح: اگر regionCode را می‌دانید، آن را در PostalAddress لحاظ کنید. /maps/documentation/address-validation/requests-validate-address را ببینید.
  • مشکل: تضمینی وجود ندارد که شیء uspsData برای همه نشانی‌های معتبرشده ایالات متحده به‌طور کامل پر شود. اصلاح: به uspsData به‌عنوان تنها سیگنال اعتبارسنجی تکیه نکنید؛ از حکم و مؤلفه‌های نشانی نیز استفاده کنید. /maps/documentation/address-validation/handle-us-address را ببینید.
  • مشکل: بازخورد ارسال‌شده با provideValidationFeedback باید به responseId از اولین تماس validateAddress در توالی ارجاع دهد، نه تماس‌های بعدی. راه‌حل: responseId را از اولین پاسخ validateAddress ذخیره کنید و آن را در درخواست بازخورد ارسال کنید. /maps/documentation/address-validation/handle-updated-address را ببینید.

کارهایی که می‌توانید با Address Validation API انجام دهید

برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیت‌ها با یکدیگر مقایسه کنید.