כשמשתמשים ב-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
משתמש באותו אופן
כתובת
ב-proto כמו השדה address
, למעט במקרים הבאים:
- לא
ConfirmationLevel
שדה - לא
unconfirmedComponentTypes
שדה
איך פועלת המרת כתובות
ה-API לאימות כתובות מחיל המרות באנגלית על כל רכיב של
את הכתובת. פירוש הדבר הוא שadministrative_area
, locality
ועוד
רכיבים של הכתובת מטופלים בנפרד. צפייה
AddressComponent
במסמכי העזר לקבלת רשימה של רכיבי הכתובת.
התרשים הבא ממחיש איך תיראה המרה באנגלית את הכתובת Calle Dueñas, 5, 41003 Seville, España.
עבור כל רכיב שמוערך להמרה באנגלית, השירות משתמש כמתואר בקטעים הבאים.
התוכן מוצג באנגלית מתורגמת במלואה כשהדבר אפשרי
ייתכן שחלק מרכיבי הכתובת כוללים גרסה מתורגמת לחלוטין שזמינה לשימוש.
לדוגמה, הספרדית (España
) תתורגם לSpain
. לחשבון
במקרה כזה, השירות משתמש בגרסה באנגלית. בדרך כלל זה המצב במקרה
רכיבי כתובת גדולים יותר, כמו country
ו-administrative_area_level_1
.
משתמש בלטינית של השפה המקומית אם אנגלית לא זמינה
לטינית פירושה שהשפה המקומית מומרה לכתב לטיני באמצעות תמלול.
- אם השפה המקומית של הכתובת כוללת תו לטיני
מוגדרת, ואין ערך מקביל באנגלית עבור רכיב הכתובת, השירות
מחליפה תווים מהשפה המקומית שלא מבוססים על אנגלית.
לדוגמה,
Calle Dueñas
הופך ל-Calle Duenas
, כאשר ñ הוא יוחלף ב-n. - אם השפה המקומית של הכתובת לא מבוססת על לטינית
ואין ערך מקביל באנגלית עבור רכיב הכתובת,
השירות משתמש בגרסה לטינית של השפה המקומית, אם יש כזו.
לדוגמה, המרה ביפנית מחזירה את המילה 'אותיות לטיניות' של יפנית.
תווים שאינם באנגלית ואינם לטיניים מוחלפים באות
תווים לטיניים. לדוגמה: 3丁目 הופכת ל-3-chome.
- לתשומת ליבכם: יפנית עדיין לא זמינה לתצוגה המקדימה
- אם אין גרסה לטינית של השפה, הרכיבים בשפה המקומית.
מחליפה תווים לטיניים ולא באנגלית
תווים לטיניים שאינם באנגלית יוחלפו בתו באנגלית מקביל. לדוגמה, כל אחד מהתווים הבאים יוחלף ב- התו 'o': סמנו, ー, ó, שוב, המאפיינים, ö, Ꮟ, נטו, , סמנו, למסור, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, , שוב, מותאמים, ổ, ?? , , פרו, ử, ở, ỡ, ợ. לדוגמה:
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.
להשתמש במנגנונים חלופיים, במיוחד אם משתמשים בסביבת ייצור. כמה דוגמאות של חלופה המצבים הבאים הם: חריגה מהמכסה, קודי תגובה לא צפויים וזמן אחזור, או תגובות לא צפויות בהשוואה להתנהגות הקיימת.
אפשר להשתמש בכלי למעקב אחרי בעיות כדי לבקש תכונות חדשות או להציע שינויים לתכונות קיימות. חשוב לכלול את הפרטים הבאים בבקשה:
כאן מתארים את התכונה או ההתנהגות הספציפית שרוצים להוסיף מהסיבות שאתם חושבים שזה חשוב.
אם אפשר, כדאי לכלול פרטים ספציפיים על התרחיש לדוגמה שלכם ועל התכונות שיהיו תואמות.
כדי לקבל את המשוב הזה או שאלות אחרות לגבי תכונות, אפשר לשלוח אימייל אל מוקד טלפוני לאימות כתובות: address-verifyation-hotline@google.com.