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

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

• אין שדה ConfirmationLevel
• שדה No unconfirmedComponentTypes

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

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

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

לדוגמה:

• 東京都渋谷区渋谷　３−２１−３　渋谷ストリーム　５階 (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"

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

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

ההמלצות האלה רלוונטיות לגרסאות טרום-GA:

• תכונות במצב טרום-GA לא כלולות בהסכם רמת השירות (SLA) של Google Maps Platform.

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

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

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

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

כדי לשלוח משוב או לשאול שאלות לגבי תכונות, אפשר לדווח על באג בIssue Tracker.