קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במסמך הזה מתוארים כמה תרחישים מהעולם האמיתי שבהם ה-API לאימות כתובות מספק אותות תגובה שמצדיקים התנהגות של הוספת מיקום משני מהמערכת שלכם. האותות האלה זמינים רק לכתובות בארה"ב.
אפשר לעיין בדוגמאות לזרימות עבודה בקטע יצירת לוגיקת אימות כדי לקבל הקשר.
דוגמה נפוצה: הוספת מיקום משנה
בתרחיש הזה מוצגת כתובת שבה המערכת עשויה לבקש מהלקוח להוסיף מספר יחידה לכתובת.
בדוגמה הבאה מתואר מצב שבו הסמל verdict מציין בעיות באיכות הכתובת שדורשות בדיקה נוספת. הדוגמאות האלה ממחישות גם איך הלוגיקה שלכם יכולה לעבור מהפסיקה לרכיבי הכתובת כדי לקבל תמונה מלאה יותר, וכך לשפר את הלוגיקה של המערכת.
חסרים רכיבים משניים של המבנה, רכיבים משוערים ורכיבים שהוחלפו
בדוגמה הזו מוצגת כתובת בארה"ב שחסר בה שם היישוב ושהמיקוד שלה שגוי.
הוזנה כתובת
אזור
1450 Brickell Avenue, FL 33132-4065
ארה"ב
פסק דין לגבי רכיבים חסרים של מיקום משנה, רכיבים שהוסקו ורכיבים שהוחלפו
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[],[],null,["This document describes a number of real-world scenarios where the\nAddress Validation API provides response signals that warrant an *add subpremises*\nbehavior from your system. These signals are only available for US addresses.\nSee [Example workflows](/maps/documentation/address-validation/build-validation-logic#example-workflows) in\n**Build your validation logic** for context.\n| **Note:** The examples here are illustrative, but don't cover all scenarios.\n\nCommon example: add subpremises\n\nThis scenario illustrates an address in which your system might prompt a\ncustomer to add a unit number to the address.\n\n| Address entered | Region |\n|--------------------------------------------|--------|\n| 1450 Brickell Avenue, Miami, FL 33131-4065 | US |\n\nVerdict for an address missing a subpremises\n\nThe example below highlights the important signal. \n\n {\n \"inputGranularity\": \"PREMISE\",\n \"validationGranularity\": \"PREMISE\",\n \"geocodeGranularity\": \"PREMISE\",\n \"possibleNextAction\": \"CONFIRM_ADD_SUBPREMISES\"\n }\n\n| **Action:** For this address, you might prompt your user to add a unit number.\n\nEdge case example: add subpremises\n\nThe following example covers a situation in which the `verdict` indicates\naddress quality issues that warrant further investigation. This examples also\nillustrates how your logic can travel from the verdict to the address components\nto obtain a more complete picture in order to enhance your system logic.\n\nMissing subpremises and inferred and replaced components\n\nThis example illustrates entry of a US address with a missing locality and an\nincorrect postal code.\n\n| Address entered | Region |\n|-------------------------------------|--------|\n| 1450 Brickell Avenue, FL 33132-4065 | US |\n\nVerdict for a missing subpremises and inferred and replaced components \n\n {\n \"inputGranularity\": \"PREMISE\",\n \"validationGranularity\": \"PREMISE\",\n \"geocodeGranularity\": \"PREMISE\",\n \"hasInferredComponents\": true,\n \"hasReplacedComponents\": true,\n \"possibleNextAction\": \"CONFIRM_ADD_SUBPREMISES\"\n }\n\nFurther investigation of the address components reveals that the locality has\nbeen inferred, and the postal code has been replaced. \n\n {\n \"componentName\": {\n \"text\": \"33131\",\n }\n \"componentType\": \"postal_code\",\n \"confirmationLevel\": \"CONFIRMED\",\n \"replaced\": true\n },\n {\n \"componentName\": {\n \"text\": \"Miami\",\n \"languageCode\": \"en\"\n }\n \"componentType\": \"locality\",\n \"confirmationLevel\": \"CONFIRMED\",\n \"inferred\": true\n }\n\n| **Action:** For this address, you might prompt your user to add a unit number, or prompt them to review the entire address."]]
