تتضمن هذه المجموعة معلومات عن الجغرافيا السياسية، وكذلك معلومات عن المسؤولين المنتخبين.
للحصول على قائمة بالطرق لهذا المورد، اطّلِع على نهاية هذه الصفحة.
تمثيلات الموارد
يشمل مورد هذه المجموعة ثلاثة أقسام، وهي موضّحة بالتفصيل أدناه. يعرض القسم divisions
التقسيمات الجغرافية السياسية، مثل بلد أو ولاية أو مقاطعة أو دائرة تشريعية. (يعتمد أي قسم سيتم إدراجه على الطلب المحدّد من واجهة برمجة التطبيقات). يسرد القسم "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 } ] } ] }
الجغرافيا السياسية
اسم الموقع | القيمة | الوصف | Notes |
---|---|---|---|
divisions |
object |
التقسيمات الجغرافية السياسية التي تحتوي على العنوان المطلوب. | |
divisions.(key) |
nested object |
المعرّف الفريد للبيانات المدنية المفتوحة لهذا القسم. | |
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 صحيحة (أو غير موجودة) في الطلب. |
مكاتب منتخبة
اسم الموقع | القيمة | الوصف | Notes |
---|---|---|---|
offices[] |
list |
المكاتب المنتخبة المشار إليها في الأقسام المذكورة أعلاه. لن يتم توفيرها إلا إذا كانت includeOffices صحيحة في الطلب. | |
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 |
ما إذا كانت هذه البيانات واردة من مصدر حكومي رسمي |
مسؤولون منتخبون
اسم الموقع | القيمة | الوصف | Notes |
---|---|---|---|
officials[] |
list |
المسؤولون الذين لديهم المناصب المذكورة أعلاه. لن يتم توفيرها إلا إذا كانت includeOffices صحيحة في الطلب. | |
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 |
عناوين URL العلنية الخاصة بالموقع الإلكتروني الرسمي |
الطُرق
- representativeInfoByAddress
- يبحث عن معلومات في الجغرافيا السياسية ومعلومات تمثيلية عن عنوان واحد.
- representativeInfoByDivision
- يبحث عن معلومات تمثيلية لقسم جغرافي واحد.