המרת כתובות לאנגלית

כשמשתמשים ב-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, למעט במקרים הבאים:

איך פועלת המרת כתובות

ה-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.