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
        }
      ]
    }
  ]
}

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

اسم الموقع القيمة الوصف 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.

وتشمل القيم الصالحة ما يلي: 
  • 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 ما إذا كانت هذه البيانات واردة من مصدر حكومي رسمي

مسؤولون منتخبون

اسم الموقع القيمة الوصف 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
يبحث عن معلومات تمثيلية لقسم جغرافي واحد.