با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
توسعه دهندگان منطقه اقتصادی اروپا (EEA).
چرا از اعتبار سنجی آدرس در Maps JavaScript API استفاده کنیم؟
کتابخانه Address Validation یک آدرس را به عنوان ورودی برای شناسایی و تأیید مؤلفه های آدرس می گیرد. همچنین آدرس پستی را استاندارد می کند و بهترین مختصات طول و عرض جغرافیایی شناخته شده را برای آن پیدا می کند. به صورت اختیاری، برای آدرس‌های ایالات متحده و پورتوریکو، می‌توانید سیستم پشتیبانی دقت کدگذاری (CASS™) را فعال کنید.
با Address Validation API، می‌توانید پیش‌بینی‌پذیری تحویل را بهبود ببخشید و خرابی‌های تحویل را کاهش دهید، در نتیجه تجربه بهتری برای مشتری فراهم کنید. شما این کار را با گرفتن آدرس های بد و به دست آوردن آگاهی بهتر از ویژگی های آدرس انجام می دهید.
کارهایی که می توانید با اعتبار سنجی آدرس در Maps JavaScript API انجام دهید
با اعتبار سنجی آدرس در Maps JavaScript API، می توانید تعیین کنید که آیا یک آدرس به یک مکان واقعی اشاره دارد یا خیر. اگر آدرس به یک مکان واقعی اشاره نمی کند، API می تواند اجزای احتمالاً اشتباهی را شناسایی کند که می توانید برای اصلاح آنها به مشتریان خود ارائه دهید. در اینجا یک نمونه گردش کار آمده است:
مشتری یک آدرس را وارد می کند - تصویر زیر یک فرم اصلی را نشان می دهد که به مشتری امکان می دهد آدرسی را وارد کند، احتمالاً به عنوان بخشی از جریان پرداخت.
برنامه آدرس را به API می فرستد - برنامه با استفاده از روش fetchAddressValidation این آدرس را ارسال می کند.
API آدرس را اعتبار سنجی و استاندارد می کند — در پاسخ، Address Validation API آدرس کاملی را که توسط API تعیین شده است برمی گرداند، یا نشان می دهد که کجا اطلاعات گم شده است.
مشتری آدرس را تأیید یا تصحیح می کند - بسته به آنچه API برمی گرداند، می توانید درخواست های زیر را به مشتری ارائه دهید:
آدرس پیشنهادی را تایید کنید.
اطلاعات گم شده را ارائه دهید.
آدرس رو درست کن
چگونه اعتبار سنجی آدرس در Maps JavaScript API کار می کند
هنگامی که فراخوانی برای fetchAddressValidation انجام می شود، API اقدامات زیر را انجام می دهد:
تصحیح می کند - بررسی های تأیید اعتبار در سطح مؤلفه، از جمله مکان های فرعی را در صورت وجود ارائه می دهد.
تکمیل - تلاش برای استنباط اجزای آدرس گم شده یا نادرست.
قالب‌ها - قالب را برای اجزای آدرس تمیز و استاندارد می‌کند.
درباره CASS™
خدمات پستی ایالات متحده® (USPS®) 1سیستم پشتیبانی دقت کدگذاری (CASS™) را برای پشتیبانی و تأیید ارائه دهندگان اعتبارسنجی آدرس حفظ می کند. یک سرویس CASS Certified™، مانند Address Validation API، به دلیل توانایی آن در پر کردن اطلاعات گم شده از یک آدرس، استاندارد کردن آن و به روز رسانی آن برای ارائه جدیدترین و دقیق ترین آدرس تأیید شده است.
CASS به طور پیش فرض فعال نیست و فقط برای مناطق "US" و "PR" پشتیبانی می شود. برای فعال کردن CASS، "enableUspsCass" را به عنوان بخشی از یک درخواست اعتبار سنجی روی "true" تنظیم کنید. برای اطلاعات بیشتر، به تأیید اعتبار یک آدرس مراجعه کنید.
به عنوان بخشی از استفاده ما از خدمات USPS، USPS درخواست‌ها را برای آدرس‌های ایجاد شده مصنوعی ارزیابی می‌کند. اگر USPS تشخیص دهد که یک آدرس ورودی به‌طور مصنوعی ایجاد شده است، Google موظف است اعتبار آدرس‌ها را برای مشتری متوقف کند و باید اطلاعات تماس مشتری (نام و آدرس)، آدرس ورودی مربوطه، و داده‌های استفاده جمع‌آوری شده را به USPS گزارش دهد. با استفاده از API با این شرایط خاص سرویس موافقت می کنید.
Google Maps Platform یک دارنده مجوز غیر انحصاری از US Postal Service® است. علامت(های) تجاری زیر متعلق به US Postal Service® است و با مجوز استفاده می شود: US Postal Service®، CASS™، CASS Certified™. ↩
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n| This product or feature is in Preview (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the [Google\n| Maps Platform Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms). For more information, see the [launch stage\n| descriptions](/maps/launch-stages).\n\nWhy use Address Validation in Maps JavaScript API? \n\nThe Address Validation library takes an address as input to identify and validate address\ncomponents. It also standardizes the address for mailing and finds the best known\nlatitude/longitude coordinates for it. Optionally, for addresses in the United States and\nPuerto Rico, you can enable the\n[Coding Accuracy Support System (CASS™)](https://developers.google.com/maps/documentation/address-validation/overview#about-cass).\n\nWith Address Validation API, you can improve delivery\npredictability and reduce delivery failures, thereby providing improved customer experience.\nYou do this by catching bad addresses and obtaining better awareness of address\ncharacteristics.\n| The Geocoding API might be a better match for your needs if you don't need to validate the individual address components. The Geocoding API **converts** addresses into latitude and longitude coordinates. The Address Validation API validates addresses for **correctness** . See [Building location validation capability using Google Maps Platform](https://developers.google.com/maps/architecture/geocoding-address-validation) in the Architecture Center for a detailed comparison.\n\nWhat you can do with Address Validation in Maps JavaScript API\n\nWith Address Validation in Maps JavaScript API, you can determine if an address refers to a\nreal place. If the address does not refer to a real place, the API can identify possibly wrong\ncomponents that you can present to your customers to correct. Here is a sample workflow:\n\n1.\n **Customer enters an address** --- The following image shows a basic form\n that allows a customer to enter an address, possibly as part of a checkout flow.\n\n2.\n **App sends the address to the API** --- The application passes this\n address using the `fetchAddressValidation` method.\n\n3.\n **API validates and standardizes the address** --- In its response, the\n Address Validation API returns the complete address as determined by the API, or\n indicates where information is missing.\n\n4.\n **Customer confirms or corrects the address** --- Depending on what the\n API returns, you can provide the following prompts to the customer:\n\n 1. Confirm the recommended address.\n 2. Provide missing information.\n 3. Fix the address.\n\nHow Address Validation in Maps JavaScript API works\n\nWhen a call to `fetchAddressValidation` is made the API attempts the following:\n\n- **Corrects** --- Provides component-level vaidation checks, including sub-premises where available.\n- **Completes** --- Attempts to infer missing or incorrect address components.\n- **Formats** --- Cleans up and standardizes the format for address components.\n\nAbout CASS™\n\nThe United States Postal Service® (USPS®)^[1](#fn1)^\nmaintains the [Coding Accuracy Support System (CASS™)](https://postalpro.usps.com/certifications/cass)\nto support and certify address validation providers. A CASS Certified™ service,\nsuch as the Address Validation API, has been confirmed for its\nability to fill in information missing from an address, standardize it, and\nupdate it to give you the most current and most accurate address.\n\nCASS is not enabled by default and is only supported for the \"US\" and \"PR\"\nregions. To enable CASS, set \\`enableUspsCass\\` to \\`true\\` as part of a validation\nrequest. For more information, see [Validate an address](/maps/documentation/javascript/address-validation/TBD).\n\nAs part of our use of USPS services, USPS evaluates requests for artificially created\naddresses. If USPS identifies an input address as being artificially created, Google is\nrequired to stop validating addresses for the customer and must report the customer's\ncontact information (name and address), the relevant input address, and aggregated usage\ndata to USPS. By using the API you consent to these\n[Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms).\n\nNext steps\n\n- [Get started with Address Validation in Maps JavaScript API](/maps/documentation/javascript/address-validation/start)\n\n*** ** * ** ***\n\n1. Google Maps Platform is a non-exclusive Licensee of the United States Postal Service®. The following trademark(s) are owned by the United States Postal Service® and used with permission: United States Postal Service®, CASS™, CASS Certified™. [↩](#fnref1)"]]
