Representatives

האוסף הזה כולל מידע על גיאוגרפיה פוליטית וכן נציגים רשמיים של גופים ציבוריים.

רשימה של ה-methods במשאב הזה מופיעה בסוף הדף.

ייצוגי משאבים

משאב באוסף הזה כולל שלושה קטעים שמתוארים בפירוט בהמשך. בקטע divisions מפורטות חלוקות גיאוגרפיות פוליטיות, כמו מדינה, מדינה (State), מחוז או מחוז חקיקה. (אילו חטיבות יופיעו בהתאם לבקשת ה-API הספציפית). בקטע offices מפורטות עמדות פוליטיות שנבחרו לייצג את החלוקות בקטע הראשון. בקטע officials מפורטים האנשים שכרגע משרתים עובדים במשרדים הרשומים.

{
  "divisions": {
    (key): {
      "name": string,
      "alsoKnownAs": [
        string
      ],
      "officeIndices": [
        unsigned integer
      ]
    }
  },
  "offices": [
    {
      "name": string,
      "divisionId": string,
      "levels": [
        string
      ],
      "roles": [
        string
      ],
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ],
      "officialIndices": [
        unsigned integer
      ]
    }
  ],
  "officials": [
    {
      "name": string,
      "address": [
        {
          "locationName": string,
          "line1": string,
          "line2": string,
          "line3": string,
          "city": string,
          "state": string,
          "zip": string
        }
      ],
      "party": string,
      "phones": [
        string
      ],
      "urls": [
        string
      ],
      "photoUrl": string,
      "emails": [
        string
      ],
      "channels": [
        {
          "type": string,
          "id": string
        }
      ]
    }
  ]
}

גיאוגרפיה פוליטית

שם הנכס ערך תיאור הערות
divisions object חלוקות גיאוגרפיות פוליטיות שמכילות את הכתובת המבוקשת.
divisions.(key) nested object המזהה הייחודי של Open Civic Data למחלקה הזו.
divisions.(key).alsoKnownAs[] list כל מזהי OCD תקינים אחרים שמפנים לאותה מחלקה.

מזהי OCD אמורים להיות קריאים לאנשים ולפחות צפויים במידה מסוימת, ולכן יש לפעמים כמה מזהים לחטיבה אחת. המזהים האלה מוגדרים כשווים זה לזה, ואחד מהם תמיד מצוין כמזהה הראשי. המזהה הראשי יוחזר בקטע ocd_id שלמעלה, וכל מזהה חוקי מקביל אחר יוחזרו ברשימה הזו.

לדוגמה, אם מזהה ה-OCD של חטיבה זו הוא ocd-division/country:us/district:dc, הוא יכיל ocd-division/country:us/state:dc.
divisions.(key).name string שם החטיבה.
divisions.(key).officeIndices[] list רשימת מדדים במערך offices – אחד לכל משרד שנבחר ממחלקה זו. יופיע רק אם הערך של includeOffices היה True (או חסר) בבקשה.

משרדים נבחרים

שם הנכס ערך תיאור הערות
offices[] list משרדים נבחרים שמוזכרים על ידי המחלקות המפורטות למעלה. יוצג רק אם הבקשה כוללת ל-includeOffices הייתה True.
offices[].divisionId string מזהה ה-OCD של המחלקה שאליה משויך המשרד הזה.
offices[].levels[] list רמות הממשל שהמשרד הזה שייך אליהן. ייתכן מצב אחד או יותר שבהם סמכות שיפוט פועלת בפועל בשתי רמות ממשל שונות; לדוגמה, ראש העיר של מחוז קולומביה פועל במסגרת "רשות מוניציפאלית". אבל גם יעיל יותר גם בadministrativeArea2 וגם ב-administrativeArea1.

הערכים החוקיים כוללים:
  • international – ממשלות בינלאומיות, כמו האו"ם או האיחוד האירופי.
  • country – ממשלות ברמה לאומית, כגון הממשלה הפדרלית של ארה"ב.
  • administrativeArea1 -- ממשלות של חלוקת משנה מנהלית ברמה העליונה של מדינה, כגון מדינות בארה"ב.
  • regional – ממשלות אזוריות שסמכות השיפוט שלהן עשויה חוצה חלוקות משנה מנהליות רגילות; המצבים האלה לא נפוצים בארה"ב, אבל נפוצים בערים גדולות במדינות אחרות.
  • administrativeArea2 – ממשלות של תת-מחוז מנהלי ברמה השנייה של מדינה, למשל מחוזות בארה"ב.
  • locality – רשויות ממשלתיות או עירוניות.
  • subLocality1 -- ממשלות של תת-מחוז מנהלי ברמה העליונה של עיר, כגון אזורי וושינגטון די. סי.
  • subLocality2 -- ממשלות של תת-מחוז מנהלי ברמה השנייה של עיר, כגון מועצות השכונה המייעצות של וושינגטון הבירה.
  • special – מחוזות מקומיים שקיימים רק בשביל רשויות ממשלתיות מיוחדות, כמו מחוזות לשימור אדמה ומים.
offices[].name string שם המשרד, קריא לאנשים.
offices[].officialIndices[] list רשימת אינדקסים במאגר הנציגים הרשמיים של האנשים שמופקדים כרגע במשרד הזה.
offices[].roles[] list התפקידים שהמשרד הזה ממלא. התפקידים לא נועדו לכלול את כל התפקידים או לפרט בדיוק את כל תחומי האחריות של משרד מסוים, אלא הם אמורים להיות קטגוריות גסות שאפשר להשתמש בהן כדי לבחור באופן כללי מתוך רשימת משרדים או למיין אותם.

הערכים החוקיים כוללים:
  • headOfState – הנציג הציבורי הבכיר של ממשלה. ראש המדינה במדינה מסוימת נקרא בדרך כלל הנשיא.
  • headOfGovernment – המנכ"ל של גוף ממשלתי. בארה"ב, זהו הנשיא; במדינות אחרות, לרוב ראש הממשלה הוא ראש הממשלה. ברמות נמוכות יותר זה יכול להיות מושל או ראש עיר.
  • deputyHeadOfGovernment – האחראי על מילוי התפקיד של ראשת הממשלה במקרה של פטירה או אי-פעילות של ראש ממשלה. בארה"ב, זהו סמנכ"ל הנשיא. למשרד הזה יכולים להיות גם תפקידים נוספים.
  • governmentOfficer – נבחר ציבור בממשלה. במדינות בארה"ב, התפקידים האלה יכולים לכלול תפקידים כמו תובע כללי, פקיד, מזכיר, מדינה או גזבר.
  • executiveCouncil – חבר במועצה ציבורית שממלאת את התפקידים המנהליים שלו כקבוצה. לדוגמה: נציבי המחוז של אינדיאנה.
  • legislatorUpperBody – איבר בחלק העליון של בית מחוקקים דו-כיווני, או הגוף היחיד של בית מחוקקים חד-מצלמות.
  • legislatorLowerBody – חבר בגוף התחתון בבית מחוקקים דו-מצלמות.
  • highestCourtJudge – שופט בבית המשפט העליון של ממשלה מסוימת, למשל בית משפט עליון של מדינה.
  • judge – שופט בכל בית משפט שאינו בית המשפט העליון של הממשל שבו הוא מכהן.
  • schoolBoard – חבר בהנהלה מקומית.
  • specialPurposeOfficer – קצין המשרת מטרה אחת ומוגדרת, למשל חבר בוועדה לשימור קרקע ומים או מנהל אחרים בתחום יתושים.
offices[].sources[] list רשימת מקורות של המשרד הזה. אם רשומים כמה מקורות, הנתונים נצברים מהמקורות האלה.
offices[].sources[].name string שם מקור הנתונים.
offices[].sources[].official boolean אם הנתונים האלה מגיעים ממקור ממשלתי רשמי.

נציגים רשמיים נבחרים

שם הנכס ערך תיאור הערות
officials[] list פקידים רשמיים במשרדים שצוינו למעלה. יוצג רק אם הבקשה כוללת ל-includeOffices הייתה True.
officials[].address[] list כתובות שבאמצעותן אפשר ליצור קשר עם הפקיד.
officials[].address[].city string העיר או העיירה של הכתובת.
officials[].address[].line1 string שם הרחוב והמספר של הכתובת הזו.
officials[].address[].line2 string בשורה השנייה הכתובת, אם צריך.
officials[].address[].line3 string השורה השלישית של הכתובת, אם יש צורך.
officials[].address[].locationName string שם המיקום.
officials[].address[].state string קיצור של שתי אותיות במדינה של הכתובת בארה"ב.
officials[].address[].zip string המיקוד בארה"ב של הכתובת.
officials[].channels[] list רשימה של ערוצי המדיה החברתית (הרשתות החברתיות) הידועים של הנציג הזה.
officials[].channels[].id string המזהה הציבורי הייחודי של הערוץ של המועמד.
officials[].channels[].type string סוג הערוץ. בהמשך מופיעה רשימה חלקית של סוגי הערוצים. יכול להיות שיתווספו עוד סוגי ערוצים בשלב מאוחר יותר. אחת מהאפשרויות: YouTube, Facebook, Twitter
officials[].emails[] list כתובות האימייל הישירות של הפקיד.
officials[].name string שם הפקיד.
officials[].party string השם המלא של המפלגה שאליה שייך הנציג הרשמי.
officials[].phones[] list מספרי הטלפון הציבוריים של הפקיד.
officials[].photoUrl string כתובת URL של תמונה של הפקיד.
officials[].urls[] list כתובות האתרים הציבוריים של הפקיד.

שיטות

representativeInfoByAddress
חיפוש מידע על מיקום גיאוגרפי פוליטי ומידע מייצג בכתובת אחת.
representativeInfoByDivision
חיפוש מידע מייצג של מחלקה גיאוגרפית אחת.