PostalAddress

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

في الاستخدام العادي، يتم إنشاء عنوان عبر إدخال المستخدم أو من خلال استيراد بيانات حالية، وفقًا لنوع العملية.

نصائح حول إدخال / تعديل العنوان: - استخدم أداة عنوان جاهزة دوليًا مثل https://github.com/google/libaddressinput) - يجب عدم تقديم عناصر واجهة المستخدم للمستخدمين لإدخال أو تعديل الحقول خارج البلدان التي يتم استخدام هذا الحقل فيها.

لمزيد من الإرشادات حول كيفية استخدام هذا المخطط، يُرجى الاطّلاع على: https://support.google.com/business/answer/6397478

تمثيل JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
الحقول
revision

integer

مراجعة مخطط PostalAddress. ويجب ضبط هذه القيمة على 0، وهي أحدث نسخة.

يجب أن تكون جميع المراجعات الجديدة متوافقة مع الإصدارات السابقة.
regionCode

string

مطلوبة. رمز منطقة CLDR للبلد/المنطقة للعنوان. ولا يتم الاستدلال على ذلك مطلقًا، كما أن المستخدم يتأكد من صحة القيمة. راجع https://cldr.unicode.org/ وhttps://www.unicode.org/cldr/charts/30/supplemental/territory_information.html للحصول على التفاصيل. مثال: "CH" لسويسرا.
languageCode

string

اختياريّ. رمز اللغة BCP-47 لمحتويات هذا العنوان (إذا كان معروفًا). وهذه اللغة هي غالبًا لغة واجهة المستخدم في نموذج الإدخال أو من المتوقّع أن تتطابق مع إحدى اللغات المستخدَمة في بلد/منطقة العنوان أو في ما يُطابقها صوتيًا. وقد يؤثر ذلك في التنسيق في بلدان معيّنة، ولكنه ليس مهمًا لصحّة البيانات ولن يؤثر أبدًا في أي عمليّة تحقّق أو عمليّات أخرى غير متعلّقة بالتنسيق.

وإذا لم تكن هذه القيمة معروفة، يجب حذفها (بدلاً من تحديد قيمة تلقائية يُحتمل أن تكون غير صحيحة).

أمثلة: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

اختياريّ. الرمز البريدي للعنوان. لا تستخدم جميع البلدان الرموز البريدية أو تتطلّب وجودها، ولكنها قد تؤدي إلى إجراء عملية تحقّق إضافية في أجزاء أخرى من العنوان في أماكن استخدامها (على سبيل المثال، التحقّق من الولاية/الرمز البريدي في الولايات المتحدة الأمريكية).
sortingCode

string

اختياريّ. شفرة تصنيف إضافية خاصة بكل بلد. ولا يتم استخدام هذا الرقم في معظم المناطق. حيثما يتم استخدامها، تكون القيمة إما سلسلة مثل "CEDEX"، متبوعة اختياريًا برقم (على سبيل المثال "CEDEX 7")، أو رقم فقط، الذي يمثل "رمز القطاع" (جامايكا)، أو "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (على سبيل المثال، ساحل العاج).
administrativeArea

string

اختياريّ. أعلى قسم فرعي إداري يستخدم للعناوين البريدية لبلد أو منطقة. على سبيل المثال: يمكن أن تكون ولاية أو مقاطعة أو مقاطعة أو محافظة. على وجه التحديد، إسبانيا هي الإقليم وليس المجتمع الذاتي (مثل "برشلونة" وليس "كتالونيا"). لا تستخدم العديد من البلدان منطقة إدارية في العناوين البريدية. على سبيل المثال، يجب عدم تعبئة هذا الحقل في سويسرا.
locality

string

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

string

اختياريّ. المنطقة الفرعية للعنوان. على سبيل المثال: يمكن أن يتمثل ذلك في أحياء، أحياء، مقاطعات.
addressLines[]

string

أسطر عنوان غير منظمة تصف المستويات الأدنى للعنوان.

نظرًا لأن القيم في addressLines لا تحتوي على معلومات النوع وقد تحتوي أحيانًا على قيم متعددة في حقل واحد (مثل "أوستن، تكساس")، من المهم أن يكون ترتيب الأسطر واضحًا. يجب أن يكون ترتيب سطور العنوان "طلب المغلف" للبلد/المنطقة من العنوان. في الأماكن التي قد يتباين فيها ذلك (على سبيل المثال، اليابان)، يتم استخدام address_language لجعلها صريحة (مثل "ja" للطلبات الكبيرة إلى الصغيرة و"ja-Latn" أو "en" للصغار والكبيرين). وبهذه الطريقة، يمكن تحديد السطر الأكثر تحديدًا في العنوان استنادًا إلى اللغة.

يتكون الحد الأدنى المسموح به للبنية الهيكلية للعنوان من رمز المنطقة مع جميع المعلومات المتبقية الموضوعة في LineLines. سيكون من الممكن تنسيق هذا العنوان إلى حد كبير جدًا بدون ترميز جغرافي، ولكن لا يمكن إجراء أي سبب دلالي حول أي من مكونات العنوان حتى يتم حله جزئيًا على الأقل.

إن إنشاء عنوان يحتوي فقط على رمز المنطقة وسطر العناوين، ثم الترميز الجغرافي هو الطريقة الموصى بها للتعامل مع العناوين غير المنظمة تمامًا (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون مناطق محلية أو مناطق إدارية).
recipients[]

string

اختياريّ. المستلم في العنوان. قد يحتوي هذا الحقل، في ظروف معينة، على معلومات متعددة الأسطر. على سبيل المثال، قد يحتوي على معلومات "الاهتمام".
organization

string

اختياريّ. اسم المؤسسة في العنوان.