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

כשמשתמשים ב-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 כמו בשדה address, עם ההחרגות הבאות:

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

ה-Address Validation API מחיל המרה לאנגלית על כל רכיב בכתובת. כלומר, המערכת מתייחסת בנפרד ל-administrative_area, ל-locality ולרכיבים אחרים של הכתובת. רשימה של רכיבי הכתובת מופיעה במאמר AddressComponent במסמכי העזרה.

בתרשים הבא מוצגת המרה באנגלית של הכתובת Calle Dueñas, 5, 41003 Sevilla, España.

רכיבי הכתובת שתורגמו, כולל 'מסלול', 'מדינה' ו'יישוב'

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

שימוש באנגלית מתורגמת במלואה במידת האפשר

יכול להיות שחלק מרכיבי הכתובת יהיו זמינים בגרסה מתורגמת במלואה. לדוגמה, המדינה España בספרד תתורגם ל-Spain. במקרה כזה, השירות ישתמש בגרסה האנגלית. בדרך כלל זה קורה ברכיבי כתובת גדולים יותר, כמו country ו-administrative_area_level_1.

אם האנגלית לא זמינה, המערכת משתמשת בכתיב לטינית של השפה המקומית

לטיניזציה פירושה שהשפה המקומית מומרת לכתב הלטיני באמצעות תמלול.

  • אם השפה המקומית של הכתובת מבוססת על מערכת תווים לטינית ואין מקבילה באנגלית לרכיב הכתובת, השירות מחליף תווים מהשפה המקומית שלא מבוססים על אנגלית. לדוגמה, הערך Calle Dueñas הופך לערך Calle Duenas, כאשר האות ñ מוחלפת ב-n.
  • אם השפה המקומית של הכתובת לא מבוססת על מערכת תווים לטינית ואין מקבילה באנגלית לרכיב הכתובת, המערכת תשתמש בגרסה לטינית של השפה המקומית, אם יש כזו. לדוגמה, המרה ביפנית מחזירה את הרומאניזציה של היפני. כל תו שאינו באנגלית ולא לטיני מוחלף באותיות לטיניות שמבוססות על אנגלית. לדוגמה: ３丁目 הופך ל-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"

אפשרויות תמיכה לגרסאות Preview

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

מומלץ להשתמש בהמלצות הבאות לגרסאות שעדיין לא הגיעו ל-GA:

  • הסכם רמת השירות של הפלטפורמה של מפות Google לא חל על תכונות בגרסת Pre-GA.

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

אתם יכולים להשתמש בכלי למעקב אחר בעיות כדי לבקש תכונות חדשות או להציע שינויים בתכונות קיימות. חשוב לכלול את הפרטים הבאים בבקשה:

  • מתארים את התכונה או את ההתנהגות הספציפית שרוצים להוסיף, וגם את הסיבות לכך.

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

כדי לשלוח משוב או שאלות נוספות לגבי התכונות, אפשר לשלוח אימייל לקו החם לאימות כתובות: address-validation-hotline@google.com.