Thông tin liên hệ

Hãy sử dụng ContactInformation để xác định thông tin liên hệ về các đối tượng, chẳng hạn như cá nhân, ban chính quyền và tổ chức.

Thực thể này chủ yếu được dùng để cung cấp URI được chú thích liên quan đến các phần tử sau: Election, ElectionAdministration, Person, GpUnit và Office.

Thuộc tính

Bảng sau đây trình bày các thuộc tính của ContactInformation:

Thuộc tính Bắt buộc? Loại Nội dung mô tả
label Không bắt buộc string Một thuộc tính không bắt buộc cho thông tin liên hệ có thể tham khảo nhãn gốc để biết thông tin. Ví dụ: nếu thông tin liên hệ đến từ một tệp CSV, thì label có thể tham chiếu đến một mã hàng.
language Không bắt buộc language Xác định ngôn ngữ dùng để cung cấp thông tin liên hệ.

Các phần tử

Bảng sau đây trình bày các phần tử cho ContactInformation:

Phần tử Số bội Loại Nội dung mô tả
AddressLine 0 trở lên string

Liên kết một địa chỉ với người liên hệ đó. AddressLine cần phải chứa các đường mà người nào đó sẽ nhập vào dịch vụ lập bản đồ web như Google Maps để tìm địa chỉ trên bản đồ. Tức là giá trị của trường cần mã hoá địa lý vị trí liên hệ.

Để bao gồm địa chỉ cho người liên hệ đó, hãy sử dụng nhiều lần AddressLine. Chúng tôi dự kiến trường hợp sử dụng đầu tiên của AddressLine sẽ là tên hoặc tổ chức. Chúng tôi dự kiến các trường hợp sử dụng tiếp theo sẽ là địa chỉ đường phố, thành phố, mã bưu chính, thành phố, tiểu bang (hoặc tiểu bang tương đương, không bắt buộc) theo thứ tự và định dạng cụ thể cho quốc gia.
Directions 0 hoặc 1 InternationalizedText Cung cấp thông tin định hướng cùng với thông tin địa chỉ. Bạn có thể sử dụng Chỉ dẫn để cung cấp mọi thông tin bổ sung liên quan đến địa chỉ có thể xuất hiện bằng nhiều ngôn ngữ.
Email 0 trở lên AnnotatedString Liên kết một địa chỉ email với người liên hệ đó. Nếu có nhiều trường Email, hãy thêm chú giải để người dùng biết mục đích của từng trường.
Fax 0 trở lên AnnotatedString Liên kết số fax với người liên hệ. Nếu có nhiều trường Fax, hãy thêm các chú thích để cho người dùng biết mục đích của từng trường.
LatLng 0 hoặc 1 LatLng Liên kết thông tin kinh độ và vĩ độ (không bắt buộc) với một địa chỉ liên hệ.
Name 0 hoặc 1 string Liên kết tên với mục liên hệ. Hãy sử dụng trường này cho những thông tin không chứa địa chỉ mà có thể giúp người dùng liên hệ với người hoặc tổ chức đó. Ví dụ: "Thư ký Văn phòng Tiểu bang, Ban Bầu cử".
Phone 0 trở lên AnnotatedString Liên kết một số điện thoại với người liên hệ đó. Nếu có nhiều trường Phone, hãy thêm chú giải để người dùng biết mục đích của từng trường.
Uri 0 trở lên AnnotatedUri Liên kết URI với địa chỉ liên hệ.

Ví dụ

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