פרטים ליצירת קשר

אפשר להשתמש ב-ContactInformation כדי להגדיר פרטים ליצירת קשר לגבי אובייקטים כמו אנשים, מועצות רשויות וארגונים.

הישות הזו משמשת בעיקר כדי לספק מזהי URI עם הערות שקשורים לרכיבים הבאים: Election, ElectionAdministration, Person, GpUnit ו-Office.

מאפיינים

בטבלה הבאה מוצגים המאפיינים של חשבון ContactInformation:

מאפיין חובה? תיאור התיאור
label אופציונלי string מאפיין אופציונלי לפרטים ליצירת קשר, שיכול להפנות לתווית המקורית של המידע. לדוגמה, אם הפרטים ליצירת קשר הגיעו מקובץ CSV, יכול להיות שהפונקציה label תתייחס למזהה שורה.
language אופציונלי language מזהה את השפה שבה נעשה שימוש כדי לספק את הפרטים ליצירת קשר.

Elements

הטבלה הבאה מציגה את הרכיבים של 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"
      ]
    }