اطلاعات تماس

ContactInformation برای تعریف اطلاعات تماس در مورد اشیاء مانند اشخاص، هیئت‌های مدیره و سازمان‌ها استفاده کنید.

این موجودیت در درجه اول برای ارائه URI های حاشیه نویسی شده مرتبط با عناصر زیر استفاده می شود: Election ، ElectionAdministration ، Person ، GpUnit و Office .

ویژگی‌ها

جدول زیر ویژگی‌های ContactInformation را نشان می‌دهد:

ویژگی الزامی است؟ نوع توضیحات
label اختیاری string یک ویژگی اختیاری برای اطلاعات تماس که می‌تواند به برچسب اصلی اطلاعات اشاره کند. برای مثال، اگر اطلاعات تماس از یک فایل CSV آمده باشد، label ممکن است به شناسه ردیف اشاره کند.
language اختیاری language زبانی را که برای ارائه اطلاعات تماس استفاده می‌شود، مشخص می‌کند.

عناصر

جدول زیر عناصر مربوط به ContactInformation را نشان می‌دهد:

عنصر چندگانگی نوع توضیحات
AddressLine ۰ یا بیشتر string

یک آدرس را به مخاطب مرتبط می‌کند. AddressLine باید شامل خطوطی باشد که شخصی برای یافتن آدرس روی نقشه در یک سرویس نقشه‌برداری وب مانند Google Maps وارد می‌کند. یعنی، مقدار این فیلد باید موقعیت مکانی مخاطب را به صورت جغرافیایی کدگذاری کند.

برای درج آدرس برای مخاطب، از چندین بار تکرار AddressLine استفاده کنید. انتظار داریم اولین استفاده از AddressLine نام یا سازمان باشد. انتظار داریم استفاده‌های بعدی شامل آدرس خیابان، شهر، کد پستی، شهر، ایالت (یا معادل ایالت، اختیاری) به ترتیب و قالب خاص کشور باشد.

Directions ۰ یا ۱ InternationalizedText علاوه بر اطلاعات آدرس، اطلاعات جهت‌یابی نیز ارائه می‌دهد. از مسیرها می‌توان برای ارائه هرگونه اطلاعات اضافی مرتبط با آدرس که ممکن است به چندین زبان ظاهر شود، استفاده کرد.
Email ۰ یا بیشتر AnnotatedString یک آدرس ایمیل را به مخاطب مرتبط می‌کند. اگر بیش از یک فیلد Email وجود دارد، حاشیه‌نویسی‌هایی را برای اطلاع کاربران از اهداف هر یک از آنها اضافه کنید.
Fax ۰ یا بیشتر AnnotatedString یک شماره فکس را به مخاطب مرتبط می‌کند. اگر بیش از یک فیلد Fax وجود دارد، حاشیه‌نویسی‌هایی را برای اطلاع کاربران از اهداف هر یک اضافه کنید.
LatLng ۰ یا ۱ LatLng اطلاعات طول و عرض جغرافیایی اختیاری را با یک آدرس تماس مرتبط می‌کند.
Name ۰ یا ۱ string یک نام را به مخاطب مرتبط می‌کند. از این فیلد برای اطلاعات غیر آدرسی استفاده کنید که می‌تواند به کاربر در تماس با آن شخص یا سازمان کمک کند. به عنوان مثال، "دفتر وزیر امور خارجه، وزارت انتخابات".
Phone ۰ یا بیشتر AnnotatedString یک شماره تلفن را به مخاطب مرتبط می‌کند. اگر بیش از یک فیلد Phone وجود دارد، حاشیه‌نویسی‌هایی را برای اطلاع کاربران از اهداف هر یک اضافه کنید.
Uri ۰ یا بیشتر 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>

جی‌سون 

    "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"
      ]
    }