Representatives

تتضمن هذه المجموعة معلومات عن الجغرافيا السياسية، وكذلك عن المسؤولين المنتخَبين.

للحصول على قائمة من الطرق لهذا المورد، راجِع نهاية هذه الصفحة.

تمثيلات الموارد

يتكون مورد في هذه المجموعة من ثلاثة أقسام، موصوفة بالتفصيل أدناه. يسرد القسم 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
        }
      ]
    }
  ]
}

الجغرافيا السياسية

اسم الموقع القيمة الوصف ملاحظات
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 صحيحًا (أو غير موجود) في الطلب.

مكاتب منتخَبة

اسم الموقع القيمة الوصف ملاحظات
offices[] list المكاتب المنتخَبة المُشار إليها من الأقسام المذكورة أعلاه لن يتوفر هذا الإعداد إلا إذا تم ضبط عبارة "includeOffices" على "صحيح" في الطلب.
offices[].divisionId string تمثّل هذه السمة رقم تعريف الوسواس القهري الخاص بالقسم الذي يرتبط به هذا المكتب.
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" على "صحيح" في الطلب.
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
البحث عن معلومات تمثيلية لقسم جغرافي واحد