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

כשמשתמשים ב-Address Validation API, אפשר לבקש שתגובת האימות תחזיר גם את הכתובת שהומרה לאנגלית. התכונה הזו שימושית כשצריך לספק במערכת מידע על כתובת באותיות לטיניות שמבוססות על אנגלית, כשמקבלים כתובת שמקורה בשפה שאינה אנגלית. לדוגמה:

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

איך מחזירים כתובת באנגלית

כדי לבקש אימות כתובת עם רכיבים מקבילים באנגלית, מוסיפים את הטקסט הבא לגוף בקשת האימות:

"languageOptions": { "returnEnglishLatinAddress": "true" }

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

curl -X POST -d '{
  "address": {
    "region_code" : "ES",
    "address_lines": ["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, עם ההבדלים הבאים:

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

כששולחים כתובת ביפנית כדי להמיר אותה לאנגלית, צריך להוסיף רווח או תו מפריד (לדוגמה, '-') בין החלקים הבאים של הכתובת:

  • מספר הבניין (הנכס) ושם הבניין.
  • מספר הבניין (הנכס) ומספר היחידה או מספר המשנה.
  • שם הבניין והמיקום בתוך הבניין.

לדוגמה:

  • 東京都渋谷区渋谷　３−２１−３　渋谷ストリーム　５階 (Recommended)
  • 東京都渋谷区渋谷３−２１−３渋谷ストリーム５階 (לא מומלץ)

דוגמאות למקרים שבהם אין שם בניין:

  • 東京都渋谷区渋谷３丁目２１−３　５階 (מומלץ)
  • 東京都渋谷区渋谷３丁目２１−３−５階 (מומלץ)
  • 東京都渋谷区渋谷３丁目２１−３５階 (לא מומלץ)

איך מתבצעת המרת כתובות

‫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"

אפשרויות תמיכה בגרסאות בטא

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

ההמלצות האלה רלוונטיות לגרסאות שלפני הזמינות הכללית:

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

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

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

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

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

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