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

כשמשתמשים ב-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.