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

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

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

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

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

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 نفس العنوان Proto كما يستخدمه الحقل address، مع الاستثناءات التالية:

آلية عمل تحويل العناوين

تطبق واجهة برمجة تطبيقات التحقق من صحة العناوين تحويل اللغة الإنجليزية على كل مكون من العنوان. وهذا يعني أنّ administrative_area وlocality وغير ذلك يتم التعامل مع مكونات العنوان بشكلٍ فردي. عرض AddressComponent في المستندات المرجعية للحصول على قائمة بمكونات العنوان.

يوضّح الرسم البياني التالي الشكل الذي ستظهر به عملية تحويل اللغة الإنجليزية إلى العنوان Calle Duetñ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

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

يوضّح المثال التالي استجابة التحقّق من صحة طلب قصر "بالاسيو" (Palacio). دي لاس دويناس في إسبانيا، مع 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-verificationation-hotline@google.com.