Thông tin liên hệ

Sử dụng ContactInformation để xác định thông tin liên hệ về các đối tượng như cá nhân, hội đồng quản trị và tổ chức.

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

Thuộc tính

Bảng sau đây cho thấy các thuộc tính của ContactInformation:

Thuộc tính Bắt buộc? Loại 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 chiếu lại nhãn ban đầu của thông tin. Ví dụ: nếu thông tin liên hệ đến từ một tệp CSV, thì label có thể đề cập đến một mã nhận dạng 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ệ.

Thành phần

Bảng sau đây cho thấy các phần tử của ContactInformation:

Phần tử Số bội Loại 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 chứa những dòng mà người dùng sẽ nhập vào một dịch vụ lập bản đồ trên web như Google Maps để tìm địa chỉ trên bản đồ. Tức là giá trị của trường cần phải mã hoá địa lý vị trí của người liên hệ.

Để thêm địa chỉ cho người liên hệ, hãy sử dụng nhiều lần xuất hiện của AddressLine. Chúng tôi dự kiến lần đầu tiên sử dụng AddressLine sẽ là tên hoặc tổ chức. Chúng tôi dự kiến các lần 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 thông tin tương đương về tiểu bang, 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 chỉ đường ngoài thông tin địa chỉ. Bạn có thể 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ú thích để cho 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 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 vĩ độ và kinh độ (không bắt buộc) với địa chỉ liên hệ.
Name 0 hoặc 1 string Liên kết tên với người liên hệ. Sử dụng trường này cho thông tin không phải địa chỉ có thể giúp người dùng liên hệ với người hoặc tổ chức đó. Ví dụ: "Văn phòng Tổng thư ký, Sở bầu cử".
Phone 0 trở lên AnnotatedString Liên kế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ú thích để cho 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 một URI với người 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"
      ]
    }