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

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

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

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

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

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 Duoñas, 5, 41003 Sevilla, España.

لكل مكوّن تم تقييمه لتحويله إلى اللغة الإنجليزية، تستخدم الخدمة العملية الموضّحة في الأقسام التالية.

استخدام اللغة الإنجليزية المترجمة بالكامل متى أمكن

قد تشتمل بعض مكونات العنوان على نسخة مترجمة بالكامل متاحة للاستخدام. على سبيل المثال، ستتم ترجمة البلد الإسباني España إلى Spain. في هذه الحالة، تستخدم الخدمة الإصدار باللغة الإنجليزية. وينطبق هذا عادةً على مكوّنات العناوين الأكبر حجمًا، مثل country وadministrative_area_level_1.

استخدام اللاتينية في اللغة المحلية إذا كانت اللغة الإنجليزية غير متوفرة

يعني الكتابة اللاتينية أن اللغة المحلية يتم تحويلها إلى النص اللاتيني باستخدام الكتابة الصوتية.

• وإذا كانت اللغة المحلية للعنوان تستخدم مجموعة أحرف لاتينية، ولم يتوفّر أي مكافئ إنجليزي لعنصر العنوان، تستبدل الخدمة أحرفًا من اللغة المحلية غير المستندة إلى الإنجليزية. على سبيل المثال، تصبح Calle Dueñas Calle Duenas، حيث يتم استبدال ñ بـ n.
• إذا كانت اللغة المحلية للعنوان لا تستخدم مجموعة أحرف مستندة إلى اللغة اللاتينية، ولم يتوفر مكافئ إنجليزي لعنصر العنوان، تستخدم الخدمة نسخة لاتينية من اللغة المحلية، إذا كانت متاحة. على سبيل المثال، عند التحويل إلى اللغة اليابانية، تظهر الكتابة بالأحرف اللاتينية الكبيرة في اللغة اليابانية. ويتم استبدال أي أحرف غير إنجليزية أو غير لاتينية بأحرف لاتينية إنجليزية. على سبيل المثال: 3丁目 يصبح 3丁目 3 chome.
  • ملاحظة: لم يتم تفعيل المعاينة باللغة اليابانية حتى الآن
• إذا لم تتوفر نسخة لاتينية من اللغة، يتم إرجاع المكونات باللغة المحلية.

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

يتم استبدال أي أحرف لاتينية ليست باللغة الإنجليزية بحروف مكافئة للأحرف الإنجليزية. على سبيل المثال، سيتم استبدال كل حرف من الأحرف التالية بالحرف "o": ووه وأو أو أو أو أو أو أو أو أو أو أو أو أو أو أو أو أو ú أو ṍ وṏ وṑ وṓ وỠ وố وṓ وỗ وố وṓ وỗ وỻ وỗ وỗ و? مثلاً:

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"

خيارات الدعم لإصدارات المعاينة

على الرغم من أنّ Google لا تدعم إصدارات أو ميزات أو وظائف المعاينة من "الخدمات"، نحن ننظر في الطلبات في هذه مراحل التطوير على أساس كل حالة على حدة.

استخدِم الاقتراحات التالية لإصدارات ما قبل التوفّر للجمهور العام:

• لا تشمل اتفاقية مستوى الخدمة في "منصة خرائط Google" ميزات ما قبل التوفّر للجمهور العام.

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

يمكنك استخدام أداة تتبّع المشاكل لطلب ميزات جديدة أو اقتراح تعديلات على الميزات الحالية. تأكد من تضمين ما يلي في طلبك:

• صِف الميزة أو السلوك المحدد الذي ترغب في إضافته، بالإضافة إلى الأسباب التي تجعلك تعتقد أنه مهم.

• إذا أمكن، قم بتضمين تفاصيل محددة حول حالة استخدامك والفرص الجديدة التي ستسمح بها الميزة.

للحصول على هذه الملاحظات أو إذا كان لديك أي أسئلة أخرى حول الميزات، يمكنك إرسال رسالة إلكترونية إلى الخط الساخن للتحقّق من صحة العنوان: address-Verifyation-hotline@google.com.