PostalAddress

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

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

يجب أن تكون جميع النُسخ السابقة الجديدة متوافقة مع النُسخ السابقة القديمة.

string

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

string

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

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

على سبيل المثال: "zh-Hant", "ja", "ja-Latn", "en".

string

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

string

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

string

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

string

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

string

اختياريّ. المنطقة الفرعية للعنوان. يمكن أن تشمل هذه الأحياء مثلاً الأحياء أو الأحياء أو الأحياء.

string

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

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

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

يُعدّ إنشاء عنوان يحتوي على رمز المنطقة ورمز addressLines فقط، ثم إنّ الترميز الجغرافي هو الطريقة المُقترَحة للتعامل مع العناوين غير المنظَّمة بالكامل (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون مناطق محلية أو مناطق إدارية).

string

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

string

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