Representatives

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

בסוף הדף הזה תוכלו למצוא רשימה של שיטות למשאב הזה.

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

למשאב באוסף הזה יש שלושה קטעים, שמתוארים בפירוט בהמשך. הקטע divisions מפרט חלוקות גיאוגרפיות פוליטיות, כגון מדינה, מדינה, מחוז או מחוז חקיקה. (אילו חטיבות יופיעו ברשימה תלויות בבקשת ה-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 ראשי תיבות של שם המדינה בן 2 האותיות בארה"ב, של הכתובת.
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
חיפוש מידע מייצג של מחלקה גיאוגרפית אחת.