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

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

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

מאפיינים

בטבלה הבאה מפורטים המאפיינים של ContactInformation:

מאפיין חובה? סוג תיאור
label אופציונלי string מאפיין אופציונלי של פרטים ליצירת קשר, שיכול להפנות בחזרה לתווית המקורית של המידע. לדוגמה, אם הפרטים ליצירת קשר הגיעו מקובץ CSV, יכול להיות ש-label מתייחס למזהה שורה.
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"
      ]
    }