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
- سرویس برای فعال کردن:
addressvalidation.googleapis.com - اصالتسنجی: کلید میانای API، OAuth 2.0، حساب سرویس
- شروع به کار: راهاندازی Address Validation API
- مرجع: مرجع Address Validation API
- قیمتگذاری: استفاده و صورتحساب Address Validation API
- خطمشیها: خطمشیهای Address Validation API
- یادداشتهای انتشار: یادداشتهای انتشار Address Validation API
بستههای رسمی 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 انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
- نشانی معتبری را برای نشانی مشخصشده یا نشانی جزئی برمیگرداند.
- مختصات عرض جغرافیایی/طول جغرافیایی را برای نشانی معتبرشده برگردانید.
- شناسه مکان Google را برای نشانی معتبرشده برگردانید.
- از گواهینامه «سیستم پشتیبانی دقت کدگذاری» (CASS) «خدمات پستی ایالات متحده» (USPS) برای اعتبارسنجی نشانی استفاده کنید.
- اطلاعاتی درباره اینکه آیا نشانی اعتبارسنجیشده کسبوکار، محل سکونت، یا صندوق پستی است برمیگرداند.
- فرادادههای تحویل «خدمات پستی ایالات متحده» (USPS) را برای نشانی معتبرشده برگردانید.
- نسخه انگلیسی نشانی معتبرشده را برمیگرداند. پیشدید
- Plus Code را برای نشانی معتبرشده برگردانید.