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

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

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

מאפיינים

הטבלה הבאה מציגה את המאפיינים של 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 משייך פרטים אופציונליים של קו רוחב וקו אורך עם איש קשר address.
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"
      ]
    }