אוסף זה כולל מידע על גיאוגרפיה פוליטית ונציגים רשמיים של גופים ציבוריים.
בסוף הדף הזה תוכלו למצוא רשימה של שיטות למשאב הזה.
ייצוגים של משאבים
למשאב באוסף הזה יש שלושה קטעים, שמתוארים בפירוט בהמשך. הקטע 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 .הערכים החוקיים כוללים:
|
|
offices[].name |
string |
שם המשרד שקריא לבני-אדם. | |
offices[].officialIndices[] |
list |
רשימת מדדים במערך הבכירים של האנשים שמכהנים כיום בתפקיד זה. | |
offices[].roles[] |
list |
התפקידים שממלא משרד זה. התפקידים לא נועדו להיות מקיפים או לציין בדיוק את כל תחומי האחריות שיש למשרד נתון. הם נועדו להיות קטגוריות גסות שיכולות לסייע לבחירה כללית מתוך רשימת משרדים או למיון הרשימה. הערכים החוקיים כוללים:
|
|
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
- חיפוש מידע מייצג של מחלקה גיאוגרפית אחת.