تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المطوّرون في المنطقة الاقتصادية الأوروبية
لماذا يجب استخدام ميزة "التحقّق من العنوان" في واجهة برمجة التطبيقات Maps JavaScript API؟
تأخذ مكتبة التحقّق من العناوين عنوانًا كمدخل لتحديد مكونات العنوان
والتحقّق منها. وتُوحد هذه الخدمة أيضًا العنوان البريدي وتبحث عن أفضل إحداثيات خطوط العرض/الطول المعروفة له. يمكنك اختياريًا تفعيل
CASS™ (نظام دعم دقة الترميز) للعناوين في الولايات المتحدة و
بورتوريكو.
باستخدام Address Validation API، يمكنك تحسين توقّعات العميل بشأن تسليم الطلبات وخفض حالات تعذُّر التسليم، ما يؤدي إلى تحسين تجربة العميل.
يمكنك إجراء ذلك من خلال رصد العناوين غير الصالحة والتعرّف بشكل أفضل على خصائص العناوين.
الإجراءات التي يمكنك تنفيذها باستخدام واجهة برمجة التطبيقات Address Validation في Maps JavaScript API
باستخدام ميزة "التحقّق من العنوان" في واجهة برمجة التطبيقات JavaScript لـ "خرائط Google"، يمكنك تحديد ما إذا كان العنوان يشير إلى
مكان حقيقي. إذا لم يشير العنوان إلى مكان حقيقي، يمكن لواجهة برمجة التطبيقات تحديد المكوّنات التي يُحتمل أن تكون خطأ
ويمكنك عرضها على عملائك لتصحيحها. في ما يلي نموذج لسير العمل:
إدخال العميل لعنوان: تعرض الصورة التالية نموذجًا أساسيًا
يتيح للعميل إدخال عنوان، ربما كجزء من عملية الدفع.
يرسل التطبيق العنوان إلى واجهة برمجة التطبيقات: يُرسل التطبيق هذا
العنوان باستخدام الطريقة fetchAddressValidation.
تحقّق واجهة برمجة التطبيقات من العنوان وتُعَدّله: في ردّها، تعرِض
Address Validation API العنوان الكامل كما تحدّده واجهة برمجة التطبيقات، أو
تشير إلى المواضع التي لا تتوفّر فيها معلومات.
تأكيد العميل للعنوان أو تصحيحه: استنادًا إلى ما تعرضه
واجهة برمجة التطبيقات، يمكنك تقديم الطلبات التالية إلى العميل:
أكِّد العنوان المقترَح.
قدِّم المعلومات غير المتوفّرة.
تصحيح العنوان
آلية عمل ميزة "التحقّق من العنوان" في Maps JavaScript API
عند إجراء طلب بيانات من fetchAddressValidation، تحاول واجهة برمجة التطبيقات إجراء ما يلي:
التصحيحات: يوفّر عمليات تحقّق من الصحة على مستوى المكوّنات، بما في ذلك
المواقع الفرعية متى توفّرت.
المكتملة: تحاول استنتاج مكونات العنوان
غير المتوفّرة أو غير الصحيحة.
التنسيقات: لتنظيف تنسيق مكونات العنوان
وتوحيده
لمحة عن CASS™
تدير شركة United States Postal Service® (USPS®)1
نظام
دعم دقة الترميز (CASS™)
لمساعدة مقدّمي خدمات التحقّق من العناوين واعتمادهم. تم تأكيد خدمة CASS Certified™،
مثل Address Validation API، على
قدرتها على ملء المعلومات غير المتوفّرة في العنوان وتوحيدها
وتعديلها لمنحك أحدث عنوان وأكثره دقة.
لا يكون معيار CASS مفعّلاً تلقائيًا ولا يتوفّر إلا في منطقتَي "الولايات المتحدة" و "بورتوريكو"
. لتفعيل CASS، اضبط enableUspsCass على true كجزء من طلب التحقّق. لمزيد من المعلومات، يمكنك الاطّلاع على التحقّق من صحة عنوان.
كجزء من استخدامنا لخدمات USPS، تقيّم USPS طلبات عناوين
تم إنشاؤها بشكل اصطناعي. إذا رصدت شركة USPS أنّ عنوان الإدخال تم إنشاؤه بشكل مصطنع، على Google
التوقف عن التحقّق من صحة العناوين للعميل، ويجب الإبلاغ عن العميل
ومعلومات الاتصال به (الاسم والعنوان) وعنوان الإدخال ذي الصلة وبيانات الاستخدام المُجمَّعة
إلى USPS. يعني استخدامك لواجهة برمجة التطبيقات موافقتك على
البنود الخاصة بالخدمة.
"منصّة خرائط Google" هي مرخّص غير حصري لخدمة البريد الأمريكي
Postal Service®. تملك خدمة البريد الأمريكي
Postal Service® العلامات التجارية التالية ويتم استخدامها بإذن: United States Postal Service®،
CASS™، CASS Certified™.
↩
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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)"]]
