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

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

string

اختياريّ. الموقع الجغرافي الفرعي للعنوان على سبيل المثال، يمكن أن يكون هذا حيًا أو منطقة أو دائرة.
addressLines[]

string

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

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

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

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

string

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

string

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