معلومات الاتصال

استخدِم النوع ContactInformation لتحديد معلومات الاتصال الخاصة بالكائنات، مثل الأشخاص ومجالس السلطات والمؤسسات.

يُستخدَم هذا العنصر بشكل أساسي لتوفير معرّفات موارد منتظمة (URI) مشروحة ذات صلة بالعناصر التالية: Election وElectionAdministration وPerson وGpUnit وOffice.

السمات

يعرض الجدول التالي سمات ContactInformation:

السمة مطلوب؟ النوع الوصف
label اختياري string سمة اختيارية لمعلومات الاتصال يمكن أن تشير إلى التصنيف الأصلي للمعلومات. على سبيل المثال، إذا كانت معلومات جهة الاتصال واردة من ملف CSV، قد يشير label إلى رقم تعريف صف.
language اختياري language تحدّد هذه السمة اللغة المستخدَمة لتقديم معلومات الاتصال.

العناصر

يعرض الجدول التالي عناصر ContactInformation:

العنصر التعددية النوع الوصف
AddressLine ‫0 أو أكثر string

يربط هذا الحقل عنوانًا بجهة الاتصال. يجب أن يتضمّن AddressLine الأسطر التي يدخلها المستخدم في خدمة خرائط على الويب، مثل "خرائط Google"، للعثور على العنوان على الخريطة. أي أنّ قيمة الحقل يجب أن تحدّد الموقع الجغرافي لجهة الاتصال.

لتضمين عنوان لجهة الاتصال، استخدِم عدة مرات AddressLine. نتوقّع أن يكون الاستخدام الأول لـ AddressLine هو الاسم أو المؤسسة. نتوقّع أن تكون الاستخدامات اللاحقة هي عنوان الشارع والمدينة والرمز البريدي والمدينة والولاية (أو ما يعادلها، وهو أمر اختياري) بالترتيب والتنسيق المحدّدَين للبلد.
Directions 0 أو 1 InternationalizedText تقدّم هذه السمة معلومات اتجاهية بالإضافة إلى معلومات العنوان. يمكن استخدام الاتجاهات لتوفير أي معلومات إضافية ذات صلة بالعنوان قد تظهر بلغات متعددة.
Email ‫0 أو أكثر AnnotatedString يربط عنوان بريد إلكتروني بجهة الاتصال. في حال توفّر أكثر من حقل Email واحد، أدرِج تعليقات توضيحية لإعلام المستخدمين بأغراض كل حقل.
Fax ‫0 أو أكثر AnnotatedString يربط رقم فاكس بجهة الاتصال. في حال توفّر أكثر من حقل Fax واحد، أدرِج تعليقات توضيحية لإعلام المستخدمين بأغراض كل حقل.
LatLng 0 أو 1 LatLng ربط معلومات خطوط الطول والعرض الاختيارية بعنوان جهة الاتصال
Name 0 أو 1 string يربط هذا الحقل اسمًا بجهة الاتصال. استخدِم هذا الحقل للمعلومات غير المتعلقة بالعنوان والتي يمكن أن تساعد المستخدم في التواصل مع هذا الشخص أو المؤسسة. على سبيل المثال، "مكتب وزير الخارجية، قسم الانتخابات".
Phone ‫0 أو أكثر AnnotatedString يربط رقم هاتف بجهة الاتصال. في حال توفّر أكثر من حقل Phone واحد، أدرِج تعليقات توضيحية لإعلام المستخدمين بأغراض كل حقل.
Uri ‫0 أو أكثر AnnotatedUri يربط هذا الحقل معرّف موارد منتظم (URI) بجهة الاتصال.

أمثلة

XML

    <ContactInformation>
      <Uri Annotation="personal-facebook">https://www.facebook.com/tedcruzpage</Uri>
      <Uri Annotation="personal-twitter">https://twitter.com/tedcruz</Uri>
      <Uri Annotation="personal-website">https://www.tedcruz.org/</Uri>
      <Uri Annotation="wikipedia">https://en.wikipedia.org/wiki/Ted_Cruz</Uri>
    </ContactInformation>
 
<ContactInformation label="ci60001" language=”es”>
      <AddressLine>Viad. Tlalpan 100</AddressLine>
      <AddressLine>Arenal Tepepan</AddressLine>
      <AddressLine>14610 Ciudad de México, CDMX</AddressLine>
      <AddressLine>Mexico</AddressLine>
      <Name>Instituto Nacional Electoral</Name>
      <Phone annotation="domestic">01 800 433 2000</Phone>
      <Phone annotation="usa">1 (866) 986 8306</Phone>
      <Phone annotation="collect">+52 (55) 5481 9897</Phone>
      <Uri Annotation="official-website">https://www.ine.mx/</Uri>
      <Uri Annotation="official-twitter">https://twitter.com/INEMexico</Uri>
      <Uri Annotation="official-facebook">https://www.facebook.com/INEMexico</Uri>
 </ContactInformation>
 
<ContactInformation label="ci10861a" language=”en”>
      <AddressLine>1600 Pennsylvania Ave</AddressLine>
      <AddressLine>Washington, DC 20006</AddressLine>
      <Email>president@whitehouse.gov</Email>
      <Phone>202-456-1111</Phone>
      <Phone annotation="TDD">202-456-6213</Phone>
      <Uri Annotation="official-website">http://www.whitehouse.gov</Uri>
      <Uri Annotation="official-facebook">https://www.facebook.com/WhiteHouse</Uri>
      <Uri Annotation="official-twitter">https://twitter.com/WhiteHouse</Uri>
</ContactInformation>

JSON

    "ContactInformation": {
      "Uri": [
        "Annotation": "personal-facebook"
        "value": "https://www.facebook.com/tedcruzpage"
      ],
      "Uri": [
        "Annotation": "personal-twitter"
        "value": "https://twitter.com/tedcruz"
      ],
      "Uri": [
        "Annotation": "personal-website"
        "value": "https://www.tedcruz.org/"
      ],
      "Uri": [
        "Annotation": "wikipedia"
        "value": "https://en.wikipedia.org/wiki/Ted_Cruz"
      ]
    }
 
    "ContactInformation": {
      "language": "es",
      "label": "ci60001",
      "AddressLine": [
        "Viad. Tlalpan 100",
        "Arenal Tepepan",
        "14610 Ciudad de México, CDMX",
        "Mexico"
      ],
      "Name": "Instituto Nacional Electoral",
      "Phone": [
        {
          "annotation": "domestic",
          "value": "01 800 433 2000"
        },
        {
          "annotation": "usa",
          "value": "1 (866) 986 8306"
        },
        {
          "annotation": "collect",
          "value": "+52 (55) 5481 9897"
        }
      ],
      "Uri": [
        "Annotation": "official-website"
        "value": "https://www.ine.mx/"
      ],
      "Uri": [
        "Annotation": "official-twitter"
        "value": "https://twitter.com/INEMexico"
      ],
      "Uri": [
        "Annotation": "official-facebook"
        "value": "https://www.facebook.com/INEMexico"
      ]
    }
 
    "ContactInformation": {
      "label": "ci10861a",
      "language": "en",
      "AddressLine": [
        "1600 Pennsylvania Ave",
        "Washington, DC 20006"
      ],
      "Email": "president@whitehouse.gov",
      "Phone": [
        {
          "value": "202-456-1111"
        },
        {
          "annotation": "TDD",
          "value": "202-456-6213"
        }
      ],
      "Uri": [
        "Annotation": "official-website"
        "value": "http://www.whitehouse.gov"
      ],
      "Uri": [
        "Annotation": "official-facebook"
        "value": "https://www.facebook.com/WhiteHouse"
      ],
      "Uri": [
        "Annotation": "official-twitter"
        "value": "https://twitter.com/WhiteHouse"
      ]
    }