聯絡資訊

請使用 ContactInformation 定義人員、主管機關、機構等物件的聯絡資訊。

這個實體主要用於提供與下列元素相關的加註 URIElectionElectionAdministrationPersonGpUnitOffice

屬性

下表列出 ContactInformation 的屬性:

屬性 必填與否 類型 說明
label 選用 string 選用屬性,用來參照相關資訊的原始標籤。舉例來說,如果聯絡資訊來自 CSV,label 可能參照資料列 ID。
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"
      ]
    }