Address Validation (beta)

AddressValidation class

google.maps.addressValidation.AddressValidation class

מחלקת סטטית לגישה לממשקי AddressValidation API.

אפשר להתקשר אל const {AddressValidation} = await google.maps.importLibrary("addressValidation") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

BetafetchAddressValidation
fetchAddressValidation(request)
פרמטרים: 
ערך מוחזר:  Promise<AddressValidation>
Betaaddress
סוג:  Address optional
מידע על הכתובת עצמה, ולא על המיקום הגיאוגרפי.
Betageocode
סוג:  Geocode optional
מידע על המיקום והמקום שאליהם הכתובת הומרה לקואורדינטות.
Betametadata
סוג:  AddressMetadata optional
מידע רלוונטי אחר שקשור ליכולת המסירה. לא מובטח שכל השדות ב-metadata יאוכלסו באופן מלא עבור כל כתובת שנשלחת אל Address Validation API.
BetaresponseId
סוג:  string optional
מזהה ה-UUID של התגובה. אם צריך לאמת מחדש את הכתובת, חובה לצרף את ה-UUID הזה לבקשה החדשה.
BetauspsData
סוג:  USPSData optional
סימונים נוספים של יכולת מסירה שסופקו על ידי USPS. המאפיין הזה מסופק רק באזורים US ו-PR.
Betaverdict
סוג:  Verdict optional
דיווחים על קביעת התקינות הכוללת
BetatoJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
הפונקציה ממירה את המחלקה AddressValidation לאובייקט JSON עם אותם מאפיינים.

AddressValidationRequest interface

google.maps.addressValidation.AddressValidationRequest ממשק

ממשק בקשות עבור BetaAddressValidation.fetchAddressValidation.

Betaaddress
הכתובת נמצאת בתהליך אימות. כתובות ללא פורמט צריך לשלוח דרך PostalAddress.addressLines.
BetapreviousResponseId optional
סוג:  string optional
אסור להגדיר את השדה הזה בבקשה הראשונה לאימות כתובת. אם צריך לשלוח עוד בקשות כדי לאמת כתובת מסוימת באופן מלא (לדוגמה, אם צריך לאמת מחדש שינויים שהמשתמש מבצע אחרי האימות הראשוני), אז בכל בקשת מעקב צריך למלא את השדה הזה עם הערך BetaAddressValidation.responseId מהתגובה הראשונה ברצף האימות.
BetauspsCASSEnabled optional
סוג:  boolean optional
הפעלת מצב תאימות ל-USPS CASS. השינוי הזה משפיע רק על השדה BetaAddressValidation.uspsData של AddressValidation. הערה: בבקשות שמופעל בהן CASS של USPS לכתובות בפוארטו ריקו, צריך לציין את PostalAddress.regionCode של address כ-"PR", או את PostalAddress.administrativeArea של address כ-"Puerto Rico" (לא תלוי באותיות רישיות) או כ-"PR".

כתובת class

google.maps.addressValidation.Address class

פרטים של הכתובת לאחר העיבוד. העיבוד שאחרי כולל תיקון חלקים בכתובת שנכתבו עם שגיאות איות, החלפה של חלקים שגויים והשלמה של חלקים חסרים.

אפשר להתקשר אל const {Address} = await google.maps.importLibrary("addressValidation") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

Betacomponents
רכיבי הכתובת האישיים של הכתובת המעוצבת והמתוקנת, יחד עם פרטי האימות. כאן מופיע מידע על סטטוס האימות של כל אחד מהרכיבים.
BetaformattedAddress
סוג:  string optional
הכתובת אחרי העיבוד, בפורמט של כתובת בשורה אחת, בהתאם לכללי הפורמט של הכתובות באזור שבו הכתובת ממוקמת.
BetamissingComponentTypes
סוג:  Array<string>
סוגי הרכיבים שהיה צפוי שיהיו בכתובת למשלוח בפורמט תקין, אבל לא נמצאו בקלט ואי אפשר היה להסיק אותם. רכיבים מהסוג הזה לא קיימים ב-formatted_address,‏ postal_address או address_components. לדוגמה, ['street_number', 'route'] עבור קלט כמו "Boulder, Colorado, 80301, USA". כאן אפשר לראות את רשימת הסוגים האפשריים.
BetapostalAddress
סוג:  PostalAddress optional
הכתובת שעברה עיבוד אחרי ההזנה, שמוצגת ככתובת למשלוח דואר.
BetaunconfirmedComponentTypes
סוג:  Array<string>
סוגי הרכיבים שמופיעים ב-address_components אבל לא הצלחנו לאמת שהם נכונים. השדה הזה מסופק לנוחותכם: התוכן שלו שווה לתוצאה של איטרציה ב-address_components כדי למצוא את הסוגים של כל הרכיבים שבהם BetaAddressComponent.confirmationLevel הוא לא BetaConfirmationLevel.CONFIRMED או שהדגל BetaAddressComponent.inferred לא מוגדר ל-true. כאן אפשר לראות את רשימת הסוגים האפשריים.
BetaunresolvedTokens
סוג:  Array<string>
אסימונים בקלט שלא ניתן לפתור. יכול להיות שזה קלט שלא זוהה כחלק תקין של כתובת (לדוגמה, בקלט כמו "123235253253 Main St, San Francisco, CA, 94105", יכול להיות שהטוקנים שלא נפתרו ייראו כמו ["123235253253"] כי זה לא נראה כמו מספר בית תקין.

AddressComponent class

google.maps.addressValidation.AddressComponent class

מייצג רכיב יחיד של כתובת (לדוגמה, שם רחוב, עיר).

אפשר להתקשר אל const {AddressComponent} = await google.maps.importLibrary("addressValidation") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

BetacomponentName
סוג:  string optional
הטקסט של שם הרכיב. לדוגמה, 'שדרת החמישית' כשם רחוב או '1253' כמספר בית.
BetacomponentNameLanguageCode
סוג:  string optional
קוד השפה BCP-47. המאפיין הזה לא יופיע אם שם הרכיב לא משויך לשפה, למשל מספר בית.
BetacomponentType
סוג:  string optional
הסוג של רכיב הכתובת. בטבלה 2: סוגים נוספים שמוחזרים על ידי שירות המקומות מופיעה רשימה של סוגים אפשריים.
BetaconfirmationLevel
סוג:  ConfirmationLevel optional
מציין את רמת הוודאות שהרכיב נכון.
Betainferred
סוג:  boolean
אם הערך הוא True, הרכיב הזה לא היה חלק מהקלט, אבל הוא נגזר ממיקום הכתובת. מומלץ לכלול את הרכיב הזה כדי לציין כתובת מלאה.
Betareplaced
סוג:  boolean
מציין שהשם של הרכיב הוחלף בשם אחר לגמרי. לדוגמה, החלפת מיקוד שגוי במיקוד הנכון לכתובת. זה לא שינוי קוסמטי, רכיב הקלט הוחלף ברכיב אחר.
BetaspellCorrected
סוג:  boolean
מציין תיקון של שגיאת כתיב בשם הרכיב. ה-API לא תמיד מסמן שינויים מגרסת איות אחת לגרסה אחרת, כמו centre ל-center.
Betaunexpected
סוג:  boolean
אם הערך הוא True, לא צפוי שהרכיב הזה יופיע בכתובת למשלוח באזור הנתון. הוא נשמר רק כי הוא היה חלק מהקלט.

AddressMetadata class

google.maps.addressValidation.AddressMetadata class

המטא-נתונים של הכתובת. לא מובטח שכל השדות ב-AddressMetadata יאוכלסו עבור כל כתובת שנשלחת אל Address Validation API.

אפשר להתקשר אל const {AddressMetadata} = await google.maps.importLibrary("addressValidation") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

Betabusiness
סוג:  boolean
BetapoBox
סוג:  boolean
Betaresidential
סוג:  boolean

ConfirmationLevel constants

google.maps.addressValidation.ConfirmationLevel constants

הערכים האפשריים השונים שמציינים את רמת הוודאות שהרכיב נכון.

אפשר להתקשר אל const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

BetaCONFIRMED
BetaUNCONFIRMED_AND_SUSPICIOUS
BetaUNCONFIRMED_BUT_PLAUSIBLE

Geocode class

google.maps.addressValidation.Geocode class

מכיל מידע על המקום שאליו הקלט גיאוקודד.

אפשר להתקשר אל const {Geocode} = await google.maps.importLibrary("addressValidation") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

Betabounds
סוג:  LatLngBounds optional
הגבולות של המקום שהומר לקואורדינטות.
BetafeatureSizeMeters
סוג:  number optional
הגודל של המקום שבוצע לו קידוד גיאוגרפי, במטרים. זהו מדד נוסף לרמת הדיוק של המיקום שפוענח באמצעות קידוד גיאוגרפי, אבל הוא מתייחס לגודל הפיזי ולא למשמעות הסמנטית.
Betalocation
סוג:  LatLngAltitude optional
המיקום של הקלט אחרי המרה לקואורדינטות.
BetaplaceId
סוג:  string optional
מזהה המקום של המקום שבוצע לו קידוד גיאוגרפי. עדיף להשתמש ב-Place במקום בכתובות, בקואורדינטות של קו אורך וקו רוחב או ב-Plus Codes. שימוש בקואורדינטות לניתוב או לחישוב מסלולי נסיעה תמיד יגרום לנקודה להיצמד לכביש הקרוב ביותר לקואורדינטות האלה. יכול להיות שזו לא דרך שתוביל במהירות או בבטחה ליעד, ושהיא לא קרובה לנקודת גישה לנכס. בנוסף, כשמבצעים פעולת פענוח גיאוגרפי הפוך של מיקום, אין ערובה לכך שהכתובת שמוחזרת תהיה זהה לכתובת המקורית.
BetaplaceTypes
סוג:  Array<string>
סוגי המקומות שהקלט הומר לקואורדינטות שלהם. לדוגמה, ['locality', 'political']. הרשימה המלאה של הסוגים זמינה בתיעוד של Geocoding API.
BetaplusCode
סוג:  PlusCode optional
ה-Plus Code שמתאים ל-location.
BetafetchPlace
fetchPlace()
פרמטרים:  אין
ערך מוחזר:  אין
מחזירה ייצוג של מקום ב-Geocode הזה. כדי לקבל את כל פרטי המקום, צריך לבצע קריאה ל-place.fetchFields().

רמת הפירוט קבועים

google.maps.addressValidation.Granularity constants

רמות הפירוט השונות שיכולות להיות לכתובת או לקואורדינטות. כשמשתמשים בערכים האלה כדי לציין את רמת הפירוט של כתובת, הם מציינים את רמת הפירוט שבה הכתובת מזהה את יעד המשלוח. לדוגמה, כתובת כמו '123 Main Street, Redwood City, CA, 94061' מזהה PREMISE, בעוד שכתובת כמו 'Redwood City, CA, 94061' מזהה LOCALITY. עם זאת, אם לא נצליח למצוא קואורדינטות גיאוגרפיות לכתובת '123 Main Street' בעיר רדווד, יכול להיות שהקואורדינטות הגיאוגרפיות שיוחזרו יהיו ברמת LOCALITYגרנולריות, למרות שהכתובת יותר גרנולרית.

אפשר להתקשר אל const {Granularity} = await google.maps.importLibrary("addressValidation") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

BetaBLOCK הכתובת או המיקום הגיאוגרפי מציינים חסימה. המאפיין הזה משמש רק באזורים שבהם יש כתובות ברמת בלוק, כמו ביפן.
BetaOTHER כל שאר רמות הפירוט, שמקובצות יחד כי אי אפשר להעביר אותן.
BetaPREMISE תוצאה ברמת הבניין.
BetaPREMISE_PROXIMITY קואורדינטות גיאוגרפיות שמשערות את המיקום של הכתובת ברמת הבניין.
BetaROUTE המיקום הגיאוגרפי או הכתובת מפורטים ברמת המסלול, למשל רחוב, כביש או כביש מהיר.
BetaSUB_PREMISE תוצאה ברמה שמתחת לרמת הבניין, כמו דירה.

USPSAddress class

google.maps.addressValidation.USPSAddress class

ייצוג של כתובת בארה"ב בפורמט של USPS.

אפשר להתקשר אל const {USPSAddress} = await google.maps.importLibrary("addressValidation") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

Betacity
סוג:  string optional
שם העיר.
BetacityStateZipAddressLine
סוג:  string optional
שורת הכתובת שמכילה את העיר, המדינה והמיקוד.
Betafirm
סוג:  string optional
שם הפירמה.
BetafirstAddressLine
סוג:  string optional
השורה הראשונה של הכתובת.
BetasecondAddressLine
סוג:  string optional
השורה השנייה של הכתובת.
Betastate
סוג:  string optional
קוד המדינה בן 2 האותיות.
Betaurbanization
סוג:  string optional
שם האזור העירוני בפורטו ריקו.
BetazipCode
סוג:  string optional
המיקוד, למשל '10009'.
BetazipCodeExtension
סוג:  string optional
תוסף המיקוד בן 4 הספרות, למשל 5023.

USPSData class

google.maps.addressValidation.USPSData class

הנתונים של USPS לגבי הכתובת. אין ערובה לכך שכל השדות ב-USPSData יאוכלסו באופן מלא עבור כל כתובת בארה"ב או בפורטו ריקו שנשלחת אל Address Validation API. מומלץ לשלב את שדות כתובת הגיבוי בתגובה אם משתמשים ב-uspsData כחלק העיקרי של התגובה.

אפשר להתקשר אל const {USPSData} = await google.maps.importLibrary("addressValidation") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

BetaabbreviatedCity
סוג:  string optional
שם העיר בקיצור.
BetaaddressRecordType
סוג:  string optional
הסוג של רשומת הכתובת שתואמת לכתובת הקלט.
BetacarrierRoute
סוג:  string optional
קוד מסלול של חברת תובלה. קוד בן ארבעה תווים שכולל תחילית של אות אחת ומספר מסלול בן שלוש ספרות.
BetacarrierRouteIndicator
סוג:  string optional
אינדיקטור למיון תעריפים של מסלולי חברות תובלה.
BetacassProcessed
סוג:  boolean
אינדיקטור שמציין שהבקשה עברה עיבוד CASS.
Betacounty
סוג:  string optional
שם המחוז.
BetadeliveryPointCheckDigit
סוג:  string optional
ספרת הביקורת של נקודת המסירה. המספר הזה מתווסף לסוף הברקוד של נקודת המסירה בדואר שנסרק באופן מכני. אם מחברים את כל הספרות של delivery_point_barcode, ‏ delivery_point_check_digit, ‏ postal code ו-ZIP+4, התוצאה צריכה להיות מספר שמתחלק ב-10.
BetadeliveryPointCode
סוג:  string optional
קוד נקודת המסירה בן 2 הספרות.
BetadpvCMRA
סוג:  string optional
מצוין אם הכתובת היא CMRA (סוכנות מסחרית לקבלת דואר) – עסק פרטי שמקבל דואר עבור לקוחות. הפונקציה מחזירה תו יחיד.
BetadpvConfirmation
סוג:  string optional
הערכים האפשריים לאישור של DPV. הפונקציה מחזירה תו יחיד או לא מחזירה ערך.
BetadpvDoorNotAccessible
סוג:  string optional
הסימון מציין כתובות שבהן שירות הדואר של ארה"ב (USPS) לא יכול לדפוק על הדלת כדי למסור דואר. הפונקציה מחזירה תו יחיד.
BetadpvDrop
סוג:  string optional
הדגל מציין שהאימייל נמסר לכלי קיבול אחד באתר. הפונקציה מחזירה תו יחיד.
BetadpvEnhancedDeliveryCode
סוג:  string optional
מציין שיותר מקוד החזרה של DPV תקף לכתובת. הפונקציה מחזירה תו יחיד.
BetadpvFootnote
סוג:  string optional
הערות השוליים מאימות נקודת המסירה. אפשר לצרף כמה הערות שוליים למחרוזת אחת.
BetadpvNonDeliveryDays
סוג:  string optional
הסימון מציין שמשלוח הדואר לא מתבצע בכל יום בשבוע. הפונקציה מחזירה תו יחיד.
BetadpvNonDeliveryDaysValues
סוג:  number optional
מספר שלם שמזהה ימים שבהם אין מסירה. אפשר לבדוק את הערך באמצעות דגלים בינאריים: 0x40 – יום ראשון הוא יום שבו לא מתבצעת מסירה 0x20 – יום שני הוא יום שבו לא מתבצעת מסירה 0x10 – יום שלישי הוא יום שבו לא מתבצעת מסירה 0x08 – יום רביעי הוא יום שבו לא מתבצעת מסירה 0x04 – יום חמישי הוא יום שבו לא מתבצעת מסירה 0x02 – יום שישי הוא יום שבו לא מתבצעת מסירה 0x01 – יום שבת הוא יום שבו לא מתבצעת מסירה
BetadpvNoSecureLocation
סוג:  string optional
הדלת נגישה, אבל החבילה לא תושאר בגלל בעיות אבטחה. הפונקציה מחזירה תו יחיד.
BetadpvNoStat
סוג:  string optional
מציין אם הכתובת היא כתובת ללא סטטיסטיקה או כתובת פעילה. כתובות ללא סטטוס הן כתובות שלא מאוכלסות באופן רציף או כתובות ששירות הדואר של ארה"ב (USPS) לא מספק להן שירות. הפונקציה מחזירה תו יחיד.
BetadpvNoStatReasonCode
סוג:  number optional
מציין את סוג ה-NoStat. מחזירה קוד סיבה כמספר שלם.
BetadpvPBSA
סוג:  string optional
מציין שהכתובת תואמת לרשומה ב-PBSA. הפונקציה מחזירה תו יחיד.
BetadpvThrowback
סוג:  string optional
מציין שהאימייל לא נמסר לכתובת הרחוב. הפונקציה מחזירה תו יחיד.
BetadpvVacant
סוג:  string optional
מציין אם הכתובת לא מאוכלסת. הפונקציה מחזירה תו יחיד.
BetaelotFlag
סוג:  string optional
הדגל eLOT Ascending/Descending (עולה/יורד).
BetaelotNumber
סוג:  string optional
מספר משופר של קו הנסיעה (eLOT).
BetaerrorMessage
סוג:  string optional
הודעת שגיאה על אחזור נתונים של USPS. השדה הזה מאוכלס כשהעיבוד של USPS מושהה בגלל זיהוי של כתובות שנוצרו באופן מלאכותי.
BetafipsCountyCode
סוג:  string optional
קוד FIPS של המחוז.
BetahasDefaultAddress
סוג:  boolean
אינדיקטור לכך שנמצאה כתובת ברירת מחדל, אבל יש כתובות ספציפיות יותר.
BetahasNoEWSMatch
סוג:  boolean
כתובת המסירה ניתנת להתאמה, אבל קובץ ה-EWS מציין שיהיה אפשר להתאים אותה בדיוק בקרוב.
BetalacsLinkIndicator
סוג:  string optional
אינדיקטור של LACSLink.
BetalacsLinkReturnCode
סוג:  string optional
קוד החזרה של LACSLink.
BetapmbDesignator
סוג:  string optional
מזהה יחידה של תיבת דואר פרטית (PMB).
BetapmbNumber
סוג:  string optional
מספר PMB (תיבת דואר פרטית).
BetapoBoxOnlyPostalCode
סוג:  boolean
מיקוד של תא דואר בלבד.
BetapostOfficeCity
סוג:  string optional
העיר שבה נמצא סניף הדואר הראשי.
BetapostOfficeState
סוג:  string optional
המדינה שבה נמצא סניף הדואר הראשי.
BetastandardizedAddress
סוג:  USPSAddress optional
כתובת סטנדרטית של USPS.
BetasuiteLinkFootnote
סוג:  string optional
הערות שוליים שנוצרות מהתאמה של רשומה של רחוב או בניין רב-קומות למידע על סוויטה. אם נמצאה התאמה לשם העסק, הפונקציה מחזירה את המספר המשני.

תוצאה סיווג

google.maps.addressValidation.Verdict class

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

אפשר להתקשר אל const {Verdict} = await google.maps.importLibrary("addressValidation") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

BetaaddressComplete
סוג:  boolean
הכתובת נחשבת מלאה אם אין בה טוקנים לא פתורים, ואין בה רכיבי כתובת לא צפויים או חסרים. אם לא מוגדר, הערך הוא false. פרטים נוספים מופיעים בשדות BetaAddress.missingComponentTypes, BetaAddress.unresolvedTokens או BetaAddressComponent.unexpected.
BetageocodeGranularity
סוג:  Granularity optional
מידע על רמת הפירוט של Geocode. אפשר להבין את זה כמשמעות הסמנטית של רמת הדיוק של המיקום שפוענח.
BetahasInferredComponents
סוג:  boolean
לפחות רכיב כתובת אחד נוסף (כלומר, הוסק) שלא היה בקלט. פרטים נוספים זמינים במאמר AddressComponent.
BetahasReplacedComponents
סוג:  boolean optional
לפחות רכיב כתובת אחד הוחלף – פרטים נוספים זמינים בAddressComponent.
BetahasUnconfirmedComponents
סוג:  boolean
לא ניתן לסווג או לאמת לפחות רכיב כתובת אחד. פרטים נוספים מופיעים בAddressComponent.
BetainputGranularity
סוג:  Granularity optional
רמת הפירוט של כתובת הקלט. זוהי תוצאה של ניתוח כתובת הקלט, והיא לא מספקת אותות אימות. למידע על אותות אימות, אפשר לעיין במאמר validationGranularity.
BetavalidationGranularity
סוג:  Granularity optional
רמת הגרנולריות שבה ה-API יכול לאמת את הכתובת באופן מלא. לדוגמה, ערך validationGranularity של PREMISE מציין שאפשר לאמת את כל רכיבי הכתובת ברמה של PREMISE וברמה רחבה יותר.