שליחת בקשה לאימות כתובת

כדי לשלוח בקשה לאימות כתובת, שולחים בקשת POST לאחת מנקודות הקצה הבאות:

• validateAddress (REST)
• ValidateAddress‏ (gRPC)

בבקשה צריך גם להעביר גוף בקשה ב-JSON שמגדיר את הכתובת שרוצים לאמת. גוף הבקשה הבא מכיל שדה אחד ושלושה שדות משנה:

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:validateAddress?key=API_KEY"

אפשר גם להשמיט את locality ולציין אותו כרכיב במערך addressLines:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

רוצים לנסות?

שדות הבקשה לכתובתו

גוף הבקשה מורכב משדה יחיד:

• address – שדה מסוג PostalAddress, שחייב להכיל לפחות רשומה אחת ב-addressLines.

כששולחים את השדה address ל-Address Validation API, צריך לספק רק שדה אחד: addressLines. עם זאת, הבקשה הפשוטה ביותר לקבלת כתובת צריכה לכלול את שדות המשנה הבאים:

• regionCode – מומלץ. זהו שדה אופציונלי, אבל אם משמיטים אותו, ה-Address Validation API מסיק את האזור מהכתובת. עם זאת, כדי לקבל את התוצאות הטובות ביותר, כדאי לכלול את regionCode אם ידוע לכם. רשימת האזורים הנתמכים מופיעה במאמר אזורים נתמכים.
• addressLines – חובה. מערך עם כתובות שמתארות את המבנה התחתון של הכתובת.

האפשרות USPS CASS™

שירות הדואר של ארצות הברית (USPS)‏¹ מנהל את מערכת התמיכה בדיווח מדויק על כתובות (CASS™) כדי לתמוך בספקי אימות כתובות ולאשר אותם.

באזורים בארה"ב ובאזורי PR בלבד, אפשר להפעיל עיבוד CASS על ידי הגדרה של enableUspsCass לערך true בגוף הבקשה. כדי לקבל את התוצאות הטובות ביותר בשימוש ב-CASS, יש לציין כתובת שכוללת את הרחוב ומספר הבית, יחד עם העיר, המדינה והמיקוד:

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

נסה בעצמך!

באמצעות API Explorer תוכלו לשלוח בקשות לדוגמה כדי להכיר את ה-API ואת אפשרויות ה-API.

1. בוחרים בסמל ה-API, , בצד שמאל של הדף.

2. אפשר גם להרחיב את האפשרות Show standard parameters ולהגדיר את הפרמטר fields למסכת השדה.

3. אם רוצים, עורכים את גוף הבקשה.

4. לוחצים על הלחצן Execute. בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש לביצוע הבקשה.

5. בחלונית של API Explorer, בוחרים בסמל ההרחבה כדי להרחיב את החלון של API Explorer.