تحويل العناوين إلى الإنجليزية

تتوفّر هذه الميزة أو المنتج في مرحلة المعاينة (مرحلة ما قبل التوفّر للجمهور العام). قد يكون دعم المنتجات والميزات المتوفرة في مرحلة ما قبل التوفّر للجمهور العام محدودًا، وقد لا تتوافق التغييرات التي يتم إجراؤها على منتجات وميزات ما قبل التوفّر للجمهور العام مع الإصدارات الأخرى المتوفّرة للجمهور العام. تغطي "عروض مرحلة ما قبل التوفّر للجمهور العام" الأحكام الخاصة بخدمة "منصة خرائط Google". لمزيد من المعلومات، يمكنك الاطّلاع على أوصاف مرحلة الإطلاق.

تحويل العنوان إلى اللغة الإنجليزية هو عملية ربط كل مكوّن عنوان يتم التعبير عنه باللغة المحلية (غير الإنجليزية) إلى مكوّن يمكن تحليله بواسطة نظام مستند إلى الإنجليزية.

عند استخدام واجهة برمجة تطبيقات التحقّق من صحة العنوان، يمكنك طلب أن يعرض ردّ التحقق أيضًا العنوان الذي تم تحويله إلى اللغة الإنجليزية. استخدِم هذه الميزة عندما يحتاج نظامك إلى تقديم معلومات العنوان بأحرف لاتينية قائمة على الإنجليزية عند تلقّي عنوان صادر بلغة غير الإنجليزية. على سبيل المثال:

• قد تفي شركتك بطلبات الشحن من جميع أنحاء العالم، وتستخدم الأحرف اللاتينية الإنجليزية والإنجليزية لتوحيد جميع العناوين.
• يمكن لنشاطك التجاري معالجة عمليات الشحن من وإلى أي بلد يستخدم لغة مختلفة عن لغة العنوان المقدَّم.

كيفية إرجاع عنوان باللغة الإنجليزية

لطلب التحقق من صحة عنوان باستخدام مكوّنات مضمّنة معادلة باللغة الإنجليزية، أضِف ما يلي إلى نص طلب التحقق من الصحة:

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. اطّلِع على مثال على الإحالة الناجحة للعنوان أدناه لمعرفة التفاصيل. يتم تحويل كل مكون من عنوان اللغة المحلية التي يتم إرجاعها إلى اللغة الإنجليزية بأسرع ما يمكن. لا يمكن إعادة استخدام العنوان الذي تم تحويله كإدخال في واجهة برمجة التطبيقات.

يستخدم الحقل englishLatinAddress نموذج العنوان نفسه الذي يستخدمه الحقل address، مع الاستثناءات التالية:

• ما مِن حقل ConfirmationLevel.
• لا يتوفّر حقل unconfirmedComponentTypes.

يستند بيان التحقّق من الصحة إلى العنوان باللغة المحلية، وليس إلى العنوان المكافئ باللغة الإنجليزية.

طريقة عمل تحويل العناوين

تطبق واجهة برمجة تطبيقات التحقق من صحة العنوان تحويل اللغة الإنجليزية على كل مكون في العنوان. هذا يعني أنّه يتم التعامل مع 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丁目 إلى 3 أجهزة منزلية.
  • يُرجى العِلم أنّه لم يتم بعد تفعيل ميزة المعاينة باللغة اليابانية.
• إذا لم تتوفر نسخة لاتينية من اللغة، يتم عرض المكونات باللغة المحلية.

استبدال الأحرف اللاتينية باللغة الإنجليزية

يتم استبدال أي أحرف لاتينية ليست باللغة الإنجليزية بما يكافئها بأحرف إنجليزية. على المثال على سبيل المثال:

Calle de Ruiz de Alarcón أصبح Calle de Ruiz de Alarcon

مثال على الإحالة الناجحة للعناوين

يوضح المثال التالي رد إثبات صحة من طلب متعلق بـ "بالاسيو دي لاس دويناس" في إسبانيا، مع كتابة 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"