כשמשתמשים ב-Address Validation API, אפשר לבקש שגם הכתובת שהומרה לאנגלית תחזיר את התשובה לאימות. משתמשים בתכונה הזו כשהמערכת צריכה לספק פרטי כתובת בתווים לטיניים מבוססי אנגלית כשמקבלים כתובת שמקורה בשפה שאינה אנגלית. למשל:
- החברה שלכם עשויה למלא בקשות למשלוח מכל רחבי העולם, ולהשתמש בתווים לטיניים באנגלית ובאנגלית כדי ליצור סטנדרטיזציה לכל הכתובות.
- יכול להיות שהעסק שלכם מטפל במשלוחים ממדינה שהשפה שלה שונה מהשפה של הכתובת שצוינה, וממנה.
איך להחזיר כתובת באנגלית
כדי לבקש אימות כתובת באמצעות רכיבים מקבילים לאנגלית, צריך להוסיף את הפרטים הבאים לגוף הבקשה לאימות:
languageOptions: { returnEnglishLatinAddress: "true" }.
בדוגמה הבאה מבקשים רכיבים באנגלית בזמן שמאמתים את הכתובת למוזיאון הפראדו:
curl -X POST -d '{ "regionCode" : ["ES"], "addressLines": ["C. de Ruiz de Alarcón, 23, 28014 Madrid, Spain"], "languageOptions": {returnEnglishLatinAddress: true} }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: API_KEY' \ 'https://addressvalidation.googleapis.com/v1:validateAddress'
התשובה תחזיר את הכתובת באנגלית בשדה englishLatinAddress
. פרטים נוספים מופיעים בקטע דוגמה להמרה של כתובת שבהמשך. כל רכיב בכתובת בשפה המקומית שמוחזרת מומר לאנגלית בצורה הטובה ביותר. אי אפשר לעשות שימוש חוזר בכתובת שהומרה כקלט ל-API.
השדה englishLatinAddress
משתמש באותו אב של כתובת שבו נעשה שימוש בשדה address
, למעט במקרים הבאים:
- ללא השדה
ConfirmationLevel
- ללא השדה
unconfirmedComponentTypes
איך פועלת המרת כתובות
ה-API לאימות כתובת מחיל את ההמרות באנגלית על כל רכיב בכתובת. המשמעות היא שהטיפול ב-administrative_area
, ב-locality
וברכיבים האחרים של הכתובת מתבצע בנפרד. רשימה של רכיבי הכתובת מופיעה במאמר AddressComponent במסמכי העזרה.
התרשים הבא ממחיש איך תיראה המרה באנגלית בכתובת Calle Dueñas, 5, 41003 Se נתח, España.
לכל רכיב שמוערך להמרה באנגלית, השירות משתמש בתהליך שמתואר בקטעים הבאים.
התוכן מוצג באנגלית מתורגמת במלואה כשהדבר אפשרי
ייתכן שחלק מרכיבי הכתובת כוללים גרסה מתורגמת לחלוטין שזמינה לשימוש.
לדוגמה, הספרדית (España
) תתורגם לSpain
. במקרה כזה, השירות משתמש בגרסה באנגלית. בדרך כלל זה המצב ברכיבי כתובת גדולים יותר כמו country
ו-administrative_area_level_1
.
משתמש בלטינית של השפה המקומית אם אנגלית לא זמינה
לטינית פירושה שהשפה המקומית מומרה לאותיות לטיניות באמצעות תמלול.
- אם השפה המקומית של הכתובת מבוססת על מערכת תווים לטינית, ואין ערך מקביל באנגלית לרכיב הכתובת, השירות יחליף תווים מהשפה המקומית שלא מבוססים על אנגלית.
לדוגמה,
Calle Dueñas
הופך ל-Calle Duenas
, ומחליפים את ñ ב-n. - אם השפה המקומית של הכתובת לא מבוססת על מערכת תווים לטינית, ואין ערך מקביל באנגלית לרכיב הכתובת, השירות ישתמש בגרסה לטינית של השפה המקומית, אם יש כזו.
לדוגמה, המרה ביפנית מחזירה את המילה 'אותיות לטיניות' של יפנית.
תווים שאינם באנגלית ואינם לטיניים מוחלפים בתווים לטיניים שמבוססים על אנגלית. לדוגמה: 3丁目 הופכת ל-3-chome.
- לתשומת ליבכם: יפנית עדיין לא זמינה לתצוגה המקדימה
- אם אין גרסה לטינית של השפה, הרכיבים יוחזרו בשפה המקומית.
מחליפה תווים לטיניים ולא באנגלית
תווים לטיניים שאינם באנגלית מוחלפים באות מקבילה לתווים באנגלית. לדוגמה, כל אחד מהתווים הבאים יוחלף בתו 'o': מילים, ò, ó, ó, ö, ö, ø, ú, ò, ú, ươ, ṍ, ṏ, ṑ, ᓹ, ọ, ỏ, ử, Display, , , Ở, Ỹ , Ỹ, Ở, ỻ, Ỹ ớ, ỻ, Ở, ổ, ỻ, Ỹ () , ( ( ל��י��) ל��ש��:
Calle de Ruiz de Alarcón הופך ל-Calle de Ruiz de Alarcon
דוגמה להמרה מסוג כתובת
בדוגמה הבאה מוצגת תגובת אימות מבקשה ל-Palacio de las Dueñas בספרד, עם englishLatinAddress
בגופן מודגש. הבקשה הזו השתמשה בשדה returnEnglishLatinAddress
בפרמטר languageOptions
בקלט.
"result": { "verdict": { "inputGranularity": "PREMISE", "validationGranularity": "PREMISE", "geocodeGranularity": "PREMISE", "addressComplete": true, "hasInferredComponents": true }, "address": { "formattedAddress": "Calle Dueñas, 5, 41003 Sevilla, España", "postalAddress": { "regionCode": "ES", "languageCode": "es", "postalCode": "41003", "administrativeArea": "Sevilla", "locality": "Sevilla", "addressLines": [ "C. Dueñas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Dueñas", "languageCode": "es" }, "componentType": "route", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "41003" }, "componentType": "postal_code", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "locality", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "España", "languageCode": "es" }, "componentType": "country", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "administrative_area_level_2", "confirmationLevel": "CONFIRMED", "inferred": true } ] }, "geocode": { "location": { "latitude": 37.394849, "longitude": -5.9893604 }, "plusCode": { "globalCode": "8C9P92V6+W7" }, "bounds": { "low": { "latitude": 37.3948098, "longitude": -5.9894249 }, "high": { "latitude": 37.3948882, "longitude": -5.9893025 } }, "featureSizeMeters": 7.174035, "placeId": "ChIJzRDYbgRsEg0RDDgHlF80UoI", "placeTypes": [ "premise" ] }, "metadata": { "business": true, "residential": false }, "englishLatinAddress": { "formattedAddress": "Calle Duenas, 5, 41003 Seville, Spain", "postalAddress": { "regionCode": "ES", "languageCode": "en", "postalCode": "41003", "administrativeArea": "Seville", "locality": "Seville", "addressLines": [ "C. Duenas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Duenas", "languageCode": "es" }, "componentType": "route", }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", }, { "componentName": { "text": "41003" }, "componentType": "postal_code", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "locality", }, { "componentName": { "text": "Spain", "languageCode": "en" }, "componentType": "country", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "administrative_area_level_2", "inferred": true } ] } }, "responseId": "e874d263-7d0d-413f-9213-119a784765ed"
אפשרויות תמיכה לגרסאות טרום-השקה
Google לא מספקת תמיכה בגרסאות, בתכונות או בפונקציונליות של השירותים לתצוגה מקדימה, אבל אנחנו מביאים בחשבון בקשות בשלבי הפיתוח האלה על בסיס כל מקרה לגופו.
יש להשתמש בהמלצו�� האלה לגרסאות טרום-GA:
תכונות טרום-GA לא נכללות בהסכם רמת השירות של הפלטפורמה של מפות Google.
כדאי להשתמש במנגנונים של חלופות, במיוחד אם אתם משתמשים בפיצ'ר טרום-GA בסביבת הייצור. דוגמאות למצבים חלופיים: חריגה מהמכסה, קודי תגובה לא צפויים וזמן אחזור לא צפוי, או תגובות לא צפויות בהשוואה להתנהגות הקיימת.
אתם יכולים להשתמש בכלי למעקב אחרי בעיות כדי לבקש תכונות חדשות או להציע שינויים בתכונות קיימות. חשוב לכלול את הפרטים הבאים בבקשה:
כאן אפשר לתאר את התכונה או ההתנהגות הספציפית שאתם רוצים שנוסיף, וגם את הסיבות לדעתך לכך.
אם אפשר, כדאי לכלול פרטים ספציפיים על התרחיש לדוגמה שלכם ועל ההזדמנויות החדשות שהתכונה תאפשר זאת.
כדי לקבל משוב או שאלות אחרות לגבי תכונות, אפשר לשלוח אימייל לקו החם לאימות כתובות: address-verifyation-hotline@google.com.