Elections: voterInfoQuery

تبحث عن معلومات ذات صلة بالناخب استنادًا إلى عنوان الناخب المسجّل التجربة الآن

قد تشمل المعلومات التي يتم إرجاعها
  • أماكن الاقتراع (بما فيها مواقع الاقتراع المبكر) لعنوان شارع سكني معين
  • معلومات عن المسابقة والمرشحين
  • معلومات رسمية عن الانتخابات

الطلب

طلب HTTP

GET https://www.googleapis.com/civicinfo/v2/voterinfo

المَعلمات

اسم المعلَمة القيمة الوصف
مَعلمات طلب البحث المطلوبة
address string العنوان المسجَّل للناخب المطلوب البحث عنه
مَعلمات طلب البحث الاختيارية
electionId long

المعرّف الفريد للانتخابات المطلوب البحث عنها يمكن الحصول على قائمة بمعرّفات الانتخابات على https://www.googleapis.com/civicinfo/{version}/Elections.

إذا لم يتم تحديد معرّف انتخابي في طلب البحث وكان هناك أكثر من انتخابات واحدة تتضمّن بيانات الناخب المحدّد، يتم عرض الانتخابات الإضافية في حقل الردّ otherElections.

إذا لم تكن هناك انتخابات مباشرة لعنوان الناخب المقدَّم، لن يعرض الردّ البيانات إلا في حال تحديد معرّف الانتخابات.

في هذه الحالة، ننصح باستخدام أي أداة إصدار طلب بحث ثانٍ يتضمّن المعرّف الانتخابي المحدّد لضمان تقديم المعلومات الصحيحة للمستخدم حول موقع الاقتراع والمسابقة والمعلومات الرسمية الانتخابية (في حال توفّرها).
officialOnly boolean وفي حال ضبطها على "صحيح"، سيتم فقط عرض البيانات من المصادر الرسمية للدولة. (القيمة التلقائية: false)

نص الطلب

لا توفِّر نص طلب بهذه الطريقة.

الإجابة

إذا نجحت هذه الطريقة، ستعرض هذه الطريقة نص استجابة بالبنية التالية:

{
  "kind": "civicinfo#voterInfoResponse",
  "election": elections Resource,
  "otherElections": [
    elections Resource
  ],
  "normalizedInput": {
    "locationName": string,
    "line1": string,
    "line2": string,
    "line3": string,
    "city": string,
    "state": string,
    "zip": string
  },
  "pollingLocations": [
    {
      "address": {
        "locationName": string,
        "line1": string,
        "line2": string,
        "line3": string,
        "city": string,
        "state": string,
        "zip": string
      },
      "notes": string,
      "pollingHours": string,
      "name": string,
      "voterServices": string,
      "startDate": string,
      "endDate": string,
      "latitude": double,
      "longitude": double,
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "earlyVoteSites": [
    {
      "address": {
        "locationName": string,
        "line1": string,
        "line2": string,
        "line3": string,
        "city": string,
        "state": string,
        "zip": string
      },
      "notes": string,
      "pollingHours": string,
      "name": string,
      "voterServices": string,
      "startDate": string,
      "endDate": string,
      "latitude": double,
      "longitude": double,
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "dropOffLocations": [
    {
      "address": {
        "locationName": string,
        "line1": string,
        "line2": string,
        "line3": string,
        "city": string,
        "state": string,
        "zip": string
      },
      "notes": string,
      "pollingHours": string,
      "name": string,
      "voterServices": string,
      "startDate": string,
      "endDate": string,
      "latitude": double,
      "longitude": double,
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "contests": [
    {
      "type": string,
      "primaryParty": string,
      "electorateSpecifications": string,
      "special": string,
      "ballotTitle": string,
      "office": string,
      "level": [
        string
      ],
      "roles": [
        string
      ],
      "district": {
        "name": string,
        "scope": string,
        "id": string
      },
      "numberElected": long,
      "numberVotingFor": long,
      "ballotPlacement": long,
      "candidates": [
        {
          "name": string,
          "party": string,
          "candidateUrl": string,
          "phone": string,
          "photoUrl": string,
          "email": string,
          "orderOnBallot": long,
          "channels": [
            {
              "type": string,
              "id": string
            }
          ]
        }
      ],
      "referendumTitle": string,
      "referendumSubtitle": string,
      "referendumUrl": string,
      "referendumBrief": string,
      "referendumText": string,
      "referendumProStatement": string,
      "referendumConStatement": string,
      "referendumPassageThreshold": string,
      "referendumEffectOfAbstain": string,
      "referendumBallotResponses": [
        string
      ],
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "state": [
    {
      "name": string,
      "electionAdministrationBody": {
        "name": string,
        "electionInfoUrl": string,
        "electionRegistrationUrl": string,
        "electionRegistrationConfirmationUrl": string,
        "electionNoticeText": string,
        "electionNoticeUrl": string,
        "absenteeVotingInfoUrl": string,
        "votingLocationFinderUrl": string,
        "ballotInfoUrl": string,
        "electionRulesUrl": string,
        "voter_services": [
          string
        ],
        "hoursOfOperation": string,
        "correspondenceAddress": {
          "locationName": string,
          "line1": string,
          "line2": string,
          "line3": string,
          "city": string,
          "state": string,
          "zip": string
        },
        "physicalAddress": {
          "locationName": string,
          "line1": string,
          "line2": string,
          "line3": string,
          "city": string,
          "state": string,
          "zip": string
        },
        "electionOfficials": [
          {
            "name": string,
            "title": string,
            "officePhoneNumber": string,
            "faxNumber": string,
            "emailAddress": string
          }
        ]
      },
      "local_jurisdiction": (AdministrationRegion),
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "mailOnly": boolean
}
اسم الموقع القيمة الوصف Notes
kind string تحدد نوع هذا المورد. القيمة: السلسلة الثابتة "civicinfo#voterInfoResponse".
election nested object الانتخابات التي تم الاستعلام عنها.
otherElections[] list إذا تم إجراء عدة انتخابات لعنوان الناخب، تتم تعبئة الحقل otherElections في ردّ واجهة برمجة التطبيقات، وهناك احتمالان:

1. إذا حدثت هذه الانتخابات في أيام مختلفة، تعرض واجهة برمجة التطبيقات معلومات التصويت في أول أو أقرب انتخابات. إذا لم تكن الانتخابات الأولى هي الانتخابات المقصودة، حدِّد رقم تعريف الانتخابات المطلوبة في طلب ثانٍ من واجهة برمجة التطبيقات باستخدام الحقل electionId.

2- إذا حدثت هذه الانتخابات في اليوم نفسه، لن تعرض واجهة برمجة التطبيقات أي معلومات متعلّقة بموقع اقتراع أو مسابقة أو معلومات رسمية انتخابية لضمان إجراء طلب إضافي. بالنسبة إلى التطبيقات الموجّهة للمستخدمين، ننصح بعرض هذه الانتخابات للمستخدمين لإزالة الغموض. ويجب تقديم طلب ثانٍ من واجهة برمجة التطبيقات باستخدام الحقل electionId لإجراء الانتخابات ذات الصلة بالمستخدم.
normalizedInput nested object النسخة التي تمت تسويتها من العنوان المطلوب
normalizedInput.locationName string اسم الموقع الجغرافي.
normalizedInput.line1 string اسم الشارع ورقم هذا العنوان
normalizedInput.line2 string أدخِل السطر الثاني العنوان، إذا لزم الأمر.
normalizedInput.line3 string تمثّل هذه السمة السطر الثالث من العنوان، إذا لزم الأمر.
normalizedInput.city string تمثّل هذه السمة المدينة أو البلدة التي يقع ضمنها العنوان.
normalizedInput.state string اختصار ولاية مكوّن من حرفَين أمريكيَين للعنوان
normalizedInput.zip string تمثّل هذه السمة الرمز البريدي في الولايات المتحدة للعنوان.
mailOnly boolean لتحديد ما إذا كان المقترعون يصوّتون في الدائرة الانتخابية فقط من خلال إرسال اقتراعاتهم عبر البريد (مع وجود خيار ممكن لسحب اقتراعيهم أيضًا)

مواقع الاقتراع ومواقع التصويت المبكر ومواقع التصويت

اسم الموقع القيمة الوصف Notes
pollingLocations[] list المواقع الجغرافية التي يكون فيها الناخب مؤهّلاً للتصويت في يوم الانتخابات
pollingLocations[].address nested object عنوان الموقع الجغرافي.
pollingLocations[].address.locationName string اسم الموقع الجغرافي.
pollingLocations[].address.line1 string اسم الشارع ورقم هذا العنوان
pollingLocations[].address.line2 string أدخِل السطر الثاني العنوان، إذا لزم الأمر.
pollingLocations[].address.line3 string تمثّل هذه السمة السطر الثالث من العنوان، إذا لزم الأمر.
pollingLocations[].address.city string تمثّل هذه السمة المدينة أو البلدة التي يقع ضمنها العنوان.
pollingLocations[].address.state string اختصار ولاية مكوّن من حرفَين أمريكيَين للعنوان
pollingLocations[].address.zip string تمثّل هذه السمة الرمز البريدي في الولايات المتحدة للعنوان.
pollingLocations[].notes string ملاحظات عن هذا الموقع الجغرافي (مثل منحدر لسهولة الاستخدام أو مدخل للاستخدام)
pollingLocations[].pollingHours string وصف لأوقات العمل في هذا الموقع
pollingLocations[].name string اسم موقع التصويت المبكر أو موقع التسليم. لا تتم تعبئة هذا الحقل لمواقع الاقتراع.
pollingLocations[].voterServices string الخدمات التي يقدّمها موقع التصويت المبكر هذا أو مكان التسليم هذا. لا تتم تعبئة هذا الحقل لمواقع الاقتراع.
pollingLocations[].startDate string التاريخ الأول الذي يمكن فيه استخدام موقع التصويت المبكر هذا أو مكان التسليم هذا. لا تتم تعبئة هذا الحقل لمواقع الاقتراع.
pollingLocations[].endDate string التاريخ الأخير الذي يمكن فيه استخدام موقع التصويت المبكر هذا أو مكان التسليم هذا. لا تتم تعبئة هذا الحقل لمواقع الاقتراع.
pollingLocations[].latitude string خط عرض الموقع بالدرجات شمال خط الاستواء. لاحظ أن هذا الحقل قد لا يكون متاحًا لبعض المواقع.
pollingLocations[].longitude string خط الطول للموقع بالدرجات شرقًا من خط الطول الرئيسي. لاحظ أن هذا الحقل قد لا يكون متاحًا لبعض المواقع.
pollingLocations[].sources[] list قائمة بالمصادر لهذا الموقع الجغرافي وإذا تم سرد عدة مصادر، يكون قد تم تجميع البيانات من هذه المصادر.
pollingLocations[].sources[].name string اسم مصدر البيانات.
pollingLocations[].sources[].official boolean ما إذا كانت هذه البيانات واردة من مصدر حكومي رسمي
earlyVoteSites[] list المواقع الجغرافية التي يكون فيها الناخب مؤهّلاً للتصويت المبكر قبل يوم الانتخابات
earlyVoteSites[].address nested object عنوان الموقع الجغرافي.
earlyVoteSites[].address.locationName string اسم الموقع الجغرافي.
earlyVoteSites[].address.line1 string اسم الشارع ورقم هذا العنوان
earlyVoteSites[].address.line2 string أدخِل السطر الثاني العنوان، إذا لزم الأمر.
earlyVoteSites[].address.line3 string تمثّل هذه السمة السطر الثالث من العنوان، إذا لزم الأمر.
earlyVoteSites[].address.city string تمثّل هذه السمة المدينة أو البلدة التي يقع ضمنها العنوان.
earlyVoteSites[].address.state string اختصار ولاية مكوّن من حرفَين أمريكيَين للعنوان
earlyVoteSites[].address.zip string تمثّل هذه السمة الرمز البريدي في الولايات المتحدة للعنوان.
earlyVoteSites[].notes string ملاحظات عن هذا الموقع الجغرافي (مثل منحدر لسهولة الاستخدام أو مدخل للاستخدام)
earlyVoteSites[].pollingHours string وصف لأوقات العمل في هذا الموقع
earlyVoteSites[].name string اسم موقع التصويت المبكر أو موقع التسليم. لا تتم تعبئة هذا الحقل لمواقع الاقتراع.
earlyVoteSites[].voterServices string الخدمات التي يقدّمها موقع التصويت المبكر هذا أو مكان التسليم هذا. لا تتم تعبئة هذا الحقل لمواقع الاقتراع.
earlyVoteSites[].startDate string التاريخ الأول الذي يمكن فيه استخدام موقع التصويت المبكر هذا أو مكان التسليم هذا. لا تتم تعبئة هذا الحقل لمواقع الاقتراع.
earlyVoteSites[].endDate string التاريخ الأخير الذي يمكن فيه استخدام موقع التصويت المبكر هذا أو مكان التسليم هذا. لا تتم تعبئة هذا الحقل لمواقع الاقتراع.
earlyVoteSites[].latitude string خط عرض الموقع بالدرجات شمال خط الاستواء. لاحظ أن هذا الحقل قد لا يكون متاحًا لبعض المواقع.
earlyVoteSites[].longitude string خط الطول للموقع بالدرجات شرقًا من خط الطول الرئيسي. لاحظ أن هذا الحقل قد لا يكون متاحًا لبعض المواقع.
earlyVoteSites[].sources[] list قائمة بالمصادر لهذا الموقع الجغرافي وإذا تم سرد عدة مصادر، يكون قد تم تجميع البيانات من هذه المصادر.
earlyVoteSites[].sources[].name string اسم مصدر البيانات.
earlyVoteSites[].sources[].official boolean ما إذا كانت هذه البيانات واردة من مصدر حكومي رسمي
dropOffLocations[] list المواقع الجغرافية التي يكون فيها الناخب مؤهلاً لسحب ورقة اقتراع مكتملة. يجب أن يكون الناخب قد حصل على اقتراع وأكمله قبل الوصول إلى الموقع الجغرافي. قد لا تتوفّر أوراق اقتراع في الموقع الجغرافي. يمكن أن تكون هذه المواقع الجغرافية مفتوحة في يوم الانتخابات أو قبله، كما هو موضّح في حقل "ساعات الاقتراع".
dropOffLocations[].address nested object عنوان الموقع الجغرافي.
dropOffLocations[].address.locationName string اسم الموقع الجغرافي.
dropOffLocations[].address.line1 string اسم الشارع ورقم هذا العنوان
dropOffLocations[].address.line2 string أدخِل السطر الثاني العنوان، إذا لزم الأمر.
dropOffLocations[].address.line3 string تمثّل هذه السمة السطر الثالث من العنوان، إذا لزم الأمر.
dropOffLocations[].address.city string تمثّل هذه السمة المدينة أو البلدة التي يقع ضمنها العنوان.
dropOffLocations[].address.state string اختصار ولاية مكوّن من حرفَين أمريكيَين للعنوان
dropOffLocations[].address.zip string تمثّل هذه السمة الرمز البريدي في الولايات المتحدة للعنوان.
dropOffLocations[].notes string ملاحظات عن هذا الموقع الجغرافي (مثل منحدر لسهولة الاستخدام أو مدخل للاستخدام)
dropOffLocations[].pollingHours string وصف لأوقات العمل في هذا الموقع
dropOffLocations[].name string اسم موقع التصويت المبكر أو موقع التسليم. لا تتم تعبئة هذا الحقل لمواقع الاقتراع.
dropOffLocations[].voterServices string الخدمات التي يقدّمها موقع التصويت المبكر هذا أو مكان التسليم هذا. لا تتم تعبئة هذا الحقل لمواقع الاقتراع.
dropOffLocations[].startDate string التاريخ الأول الذي يمكن فيه استخدام موقع التصويت المبكر هذا أو مكان التسليم هذا. لا تتم تعبئة هذا الحقل لمواقع الاقتراع.
dropOffLocations[].endDate string التاريخ الأخير الذي يمكن فيه استخدام موقع التصويت المبكر هذا أو مكان التسليم هذا. لا تتم تعبئة هذا الحقل لمواقع الاقتراع.
dropOffLocations[].latitude string خط عرض الموقع بالدرجات شمال خط الاستواء. لاحظ أن هذا الحقل قد لا يكون متاحًا لبعض المواقع.
dropOffLocations[].longitude string خط الطول للموقع بالدرجات شرقًا من خط الطول الرئيسي. لاحظ أن هذا الحقل قد لا يكون متاحًا لبعض المواقع.
dropOffLocations[].sources[] list قائمة بالمصادر لهذا الموقع الجغرافي وإذا تم سرد عدة مصادر، يكون قد تم تجميع البيانات من هذه المصادر.
dropOffLocations[].sources[].name string اسم مصدر البيانات.
dropOffLocations[].sources[].official boolean ما إذا كانت هذه البيانات واردة من مصدر حكومي رسمي

المسابقات

اسم الموقع القيمة الوصف Notes
contests[] list المسابقات التي ستظهر في اقتراع الناخب.
contests[].type string تمثّل هذه السمة نوع المسابقة. عادةً ما تكون هذه المجموعة "عام" أو "أساسي" أو "إعادة جولة" في المسابقات التي يتم فيها إجراء المسابقات مع المرشحين. للاستفتاءات، سيكون هذا المصطلح "مراجعة".
contests[].primaryParty string إذا كانت هذه الانتخابات حزبية، يجب تحديد اسم الحزب الذي تنتمي إليه.
contests[].electorateSpecifications string وصف لأي متطلبات أهلية إضافية للتصويت في هذه المسابقة.
contests[].special string "نعم" أو "لا" استنادًا إلى ما إذا كانت هذه المسابقة ستجري خارج دورة الانتخابات العادية.
contests[].ballotTitle string العنوان الرسمي الوارد في ورقة الاقتراع لهذه المسابقة عند توفّره.
contests[].office string تمثّل هذه السمة اسم المكتب الخاص بهذه المسابقة.
contests[].level[] list مستويات الحكومة التي ينتمي إليها مكتب هذه المسابقة. قد تكون هناك أكثر من حالة واحدة في الحالات التي يمارس فيها نطاق السلطة بشكلٍ فعّال على مستويَين مختلفَين من الحكومة. على سبيل المثال، يتولّى عمدة مقاطعة كولومبيا منصبه على المستوى locality، ولكن على مستوى administrativeArea2 وadministrativeArea1 أيضًا.

وتشمل القيم الصالحة ما يلي: 
  • international -- الحكومات الدولية، مثل الأمم المتحدة أو الاتحاد الأوروبي
  • country -- الحكومات على المستوى الوطني، مثل الحكومة الفيدرالية الأمريكية
  • administrativeArea1 -- حكومات القسم الفرعي الإداري ذي المستوى الأعلى في بلد معيّن، مثل الولايات الأمريكية.
  • regional -- الحكومات الإقليمية التي قد يقع نطاق سلطتها على أقسام فرعية إدارية عادية، وهذه الحالة غير شائعة في الولايات المتحدة، ولكنّها شائعة في المدن الكبيرة في بلدان أخرى.
  • administrativeArea2 -- حكومات التقسيم الفرعي الإداري الثاني للبلد، مثل المقاطعات الأمريكية
  • locality -- حكومات المدن أو البلديات
  • subLocality1 -- حكومات الأقسام الفرعية الإدارية ذات المستوى الأعلى للمدينة، مثل أقسام واشنطن العاصمة
  • subLocality2 -- حكومات القسم الفرعي الإداري الثاني للمدينة، مثل مجالس الأحياء الاستشارية في واشنطن العاصمة.
  • special -- المناطق المحلية التي يتواجد فيها الحكومات ذات الأغراض الخاصة فقط، مثل مناطق الحفاظ على التربة والمياه
contests[].roles[] list الأدوار التي يتولّاها المنصب في هذه المسابقة. لا يُقصد بالأدوار أن تكون شاملة أو تحدِّد المجموعة الكاملة للمسؤوليات لكل مكتب، ولكن يُقصد منها أن تكون فئات تقريبية مفيدة للاختيار العام من قائمة المناصب أو فرزها.

تشمل القيم الصالحة ما يلي:
  • headOfState -- الممثل العام الرئيس للحكومة. يُعرف رئيس الدولة عادةً باسم الرئيس.
  • headOfGovernment -- المدير التنفيذي لحكومة ما الرئيس في الولايات المتحدة هو رئيس الوزراء، وفي بلدان أخرى غالبًا ما يكون رئيس الوزراء. وقد يكون هذا الشخص حاكمًا أو عمدًا في المستويات الأدنى.
  • deputyHeadOfGovernment -- الموظف المسؤول عن تولّي منصب رئيس الحكومة في حال وفاة رئيس الحكومة المنتخَب أو عجزه في الولايات المتحدة، هذا هو نائب الرئيس. قد يكون لهذا المكتب واجبات أخرى أيضًا.
  • governmentOfficer -- مسؤول فرع تنفيذي مُنتخَب وفي الولايات الأمريكية، قد يشمل ذلك المناصب، مثل المدّعي العام أو مراقب الحساب أو السكرتير أو الدولة أو أمين الخزانة.
  • executiveCouncil -- عضو في مجلس تنفيذي يمارس أدوار الفرع التنفيذي كمجموعة. وتشمل الأمثلة مفوضي مقاطعة إنديانا.
  • legislatorUpperBody -- عضو في الهيئة التشريعية ذات المجلسَين أو الهيئة الوحيدة لمجلس تشريعي أحادي المجلس
  • legislatorLowerBody -- عضو في الجزء السفلي من هيئة تشريعية ذات مجلسَين
  • highestCourtJudge -- قاضٍ في المحكمة العليا في حكومة معيّنة، مثل المحكمة العليا للولاية
  • judge -- قاضٍ في أي محكمة ليست المحكمة العليا في الحكومة التي تخدمها هذه المحكمة.
  • schoolBoard -- عضو في مجلس إدارة مؤسسة تعليمية محلية
  • specialPurposeOfficer -- مسؤول يخدم غرضًا واحدًا محدّدًا، مثل أحد أعضاء مجلس الحفاظ على التربة والمياه أو مسؤول عن مكافحة البعوض
contests[].district nested object معلومات عن الدائرة الانتخابية التي تتضمنها هذه المسابقة
contests[].district.name string اسم المنطقة
contests[].district.scope string النطاق الجغرافي لهذه المنطقة. في حال عدم تحديد موقع جغرافي للدائرة، أحد الخيارات التالية: على المستوى الوطني أو على مستوى الولاية أو مجلس النواب أو الولاية أو الولاية الصغرى أو على مستوى المقاطعة أو القضاء أو المجلس المدرسي أو المدينة أو البلدية أو المجلس المحلي أو مجلس المدينة أو المجلس الخاص أو مؤسسة خاصة

القيم المقبولة هي:
  • "cityCouncil"
  • "citywide"
  • "congressional"
  • "countyCouncil"
  • "countywide"
  • "judicial"
  • "national"
  • "schoolBoard"
  • "special"
  • "stateLower"
  • "stateUpper"
  • "statewide"
  • "township"
  • "ward"
contests[].district.id string معرّف لهذه المنطقة التعليمية نسبةً إلى نطاقها على سبيل المثال، قد يكون للدائرة الانتخابية الرابعة والثلاثين رقم التعريف "34" ونطاق StateUpper.
contests[].numberElected long يشير هذا المقياس إلى عدد المرشحين الذين سيتم انتخابهم لمنصب في هذه المسابقة.
contests[].numberVotingFor long عدد المرشحين الذين يمكن أن يصوّتوا لصالحهم في هذه المسابقة
contests[].ballotPlacement long رقم يحدد موضع هذه المسابقة على اقتراع الناخب.
contests[].candidates[] list اختيارات المرشح لهذه المسابقة.
contests[].candidates[].name string تمثّل هذه السمة اسم المرشّح.
contests[].candidates[].party string الاسم الكامل للحزب المرشح الذي ينتمي إليه
contests[].candidates[].candidateUrl string عنوان URL للموقع الإلكتروني الخاص بحملة المرشّح.
contests[].candidates[].phone string رقم الهاتف الصوتي لمكتب الحملة الإعلانية للمرشّح.
contests[].candidates[].photoUrl string تمثّل هذه السمة عنوان URL لصورة المرشّح.
contests[].candidates[].email string عنوان البريد الإلكتروني لحملة المرشّح.
contests[].candidates[].orderOnBallot long الترتيب الذي يظهر فيه المرشّح في ورقة اقتراع هذه المسابقة
contests[].candidates[].channels[] list قائمة بقنوات وسائل التواصل الاجتماعي (الاجتماعية) المعروفة لهذا المرشح.
contests[].candidates[].channels[].type string نوع القناة في ما يلي قائمة بأنواع القنوات، ولكنها ليست شاملة. وقد تتم إضافة المزيد من أنواع القنوات في وقت لاحق. أحد الخيارات التالية:
  • GooglePlus
  • YouTube
  • Facebook
  • Twitter
contests[].candidates[].channels[].id string المعرّف العام الفريد لقناة المرشّح
contests[].referendumTitle string عنوان الاستفتاء (مثل "الاقتراح 42") تتم تعبئة هذا الحقل للمسابقات من النوع "مرجع" فقط.
contests[].referendumSubtitle string وصف موجز للاستفتاء تتم تعبئة هذا الحقل للمسابقات من النوع "مرجع" فقط.
contests[].referendumUrl string رابط للاستفتاء تتم تعبئة هذا الحقل للمسابقات من النوع "مرجع" فقط.
contests[].referendumBrief string تحدّد هذه السمة ملخّصًا قصيرًا للاستفتاء يظهر عادةً على ورقة الاقتراع أسفل العنوان ولكن فوق النص. تتم تعبئة هذا الحقل للمسابقات من النوع "مرجع" فقط.
contests[].referendumText string النص الكامل للاستفتاء. تتم تعبئة هذا الحقل للمسابقات من النوع "مرجع" فقط.
contests[].referendumProStatement string بيان لصالح الاستفتاء. ولا يظهر بالضرورة في بطاقة الاقتراع. تتم تعبئة هذا الحقل للمسابقات من النوع "مرجع" فقط.
contests[].referendumConStatement string بيان يعارض الاستفتاء ولا يظهر بالضرورة في بطاقة الاقتراع. تتم تعبئة هذا الحقل للمسابقات من النوع "مرجع" فقط.
contests[].referendumPassageThreshold string الحدّ الأدنى لعدد الأصوات التي يحتاجها الاستفتاء لاجتيازه، مثل "الثلثان" تتم تعبئة هذا الحقل للمسابقات من النوع "مرجع" فقط.
contests[].referendumEffectOfAbstain string يحدد التأثير الذي سيترتب على الامتناع عن الاقتراح (وليس التصويت) على الاقتراح (أي ما إذا كان الامتناع عن التصويت يُعد تصويتًا ضده). تتم تعبئة هذا الحقل للمسابقات من النوع "مرجع" فقط.
contests[].referendumBallotResponses[] list مجموعة الردود على الاقتراع في الاستفتاء. يمثّل الردّ على ورقة الاقتراع سطرًا على ورقة الاقتراع. قد تتضمن الأمثلة الشائعة "نعم" أو "لا" للاستفتاءات أو اسم القاضي في مسابقة للاحتفاظ بالبيانات. تتم تعبئة هذا الحقل للمسابقات من النوع "مرجع" فقط.
contests[].sources[] list قائمة بمصادر هذه المسابقة. وإذا تم سرد عدة مصادر، يكون قد تم تجميع البيانات من هذه المصادر.
contests[].sources[].name string اسم مصدر البيانات.
contests[].sources[].official boolean ما إذا كانت هذه البيانات واردة من مصدر حكومي رسمي

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

اسم الموقع القيمة الوصف Notes
state[] list معلومات الانتخابات المحلية للولاية التي يصوّت فيها الناخب بالنسبة إلى الولايات المتحدة، سيكون هناك عنصر واحد فقط في هذه الصفيفة.
state[].name string اسم نطاق السلطة
state[].electionAdministrationBody nested object هيئة إدارة الانتخابات لهذه المنطقة
state[].electionAdministrationBody.name string اسم هذه الهيئة الإدارية للانتخابات.
state[].electionAdministrationBody.electionInfoUrl string عنوان URL تقدّمه هذه الهيئة الإدارية للبحث عن معلومات عامة عن الانتخابات.
state[].electionAdministrationBody.electionRegistrationUrl string عنوان URL تقدّمه هذه الهيئة الإدارية للبحث عن كيفية التسجيل للتصويت.
state[].electionAdministrationBody.electionRegistrationConfirmationUrl string عنوان URL تقدّمه هذه الهيئة الإدارية لتأكيد تسجيل الناخب للتصويت.
state[].electionAdministrationBody.electionNoticeText string نص إشعار في اللحظة الأخيرة أو إشعار بالطوارئ تقدّمه هذه الهيئة الإدارية.
state[].electionAdministrationBody.electionNoticeUrl string عنوان URL تقدّمه هذه الهيئة الإدارية للحصول على معلومات إضافية ذات صلة بالدقيقة الأخيرة أو إشعار الطوارئ.
state[].electionAdministrationBody.absenteeVotingInfoUrl string عنوان URL تقدّمه هذه الهيئة الإدارية للحصول على معلومات عن التصويت الغيابي.
state[].electionAdministrationBody.votingLocationFinderUrl string عنوان URL تقدّمه هذه الهيئة الإدارية للبحث عن أماكن التصويت.
state[].electionAdministrationBody.ballotInfoUrl string عنوان URL تقدّمه هذه الهيئة الإدارية لتقديم معلومات عن المسابقة للناخب.
state[].electionAdministrationBody.electionRulesUrl string عنوان URL تقدّمه هذه الهيئة الإدارية لوصف قواعد الانتخابات للناخب.
state[].electionAdministrationBody.voter_services[] list وصف للخدمات التي قد تقدمها هذه الهيئة الإدارية.
state[].electionAdministrationBody.hoursOfOperation string وصف لساعات العمل لهذه الهيئة الإدارية.
state[].electionAdministrationBody.correspondenceAddress nested object العنوان البريدي لهذه الهيئة الإدارية.
state[].electionAdministrationBody.correspondenceAddress.locationName string اسم الموقع الجغرافي.
state[].electionAdministrationBody.correspondenceAddress.line1 string اسم الشارع ورقم هذا العنوان
state[].electionAdministrationBody.correspondenceAddress.line2 string أدخِل السطر الثاني العنوان، إذا لزم الأمر.
state[].electionAdministrationBody.correspondenceAddress.line3 string تمثّل هذه السمة السطر الثالث من العنوان، إذا لزم الأمر.
state[].electionAdministrationBody.correspondenceAddress.city string تمثّل هذه السمة المدينة أو البلدة التي يقع ضمنها العنوان.
state[].electionAdministrationBody.correspondenceAddress.state string اختصار ولاية مكوّن من حرفَين أمريكيَين للعنوان
state[].electionAdministrationBody.correspondenceAddress.zip string تمثّل هذه السمة الرمز البريدي في الولايات المتحدة للعنوان.
state[].electionAdministrationBody.physicalAddress nested object العنوان الجغرافي لهذه الهيئة الإدارية.
state[].electionAdministrationBody.physicalAddress.locationName string اسم الموقع الجغرافي.
state[].electionAdministrationBody.physicalAddress.line1 string اسم الشارع ورقم هذا العنوان
state[].electionAdministrationBody.physicalAddress.line2 string أدخِل السطر الثاني العنوان، إذا لزم الأمر.
state[].electionAdministrationBody.physicalAddress.line3 string تمثّل هذه السمة السطر الثالث من العنوان، إذا لزم الأمر.
state[].electionAdministrationBody.physicalAddress.city string تمثّل هذه السمة المدينة أو البلدة التي يقع ضمنها العنوان.
state[].electionAdministrationBody.physicalAddress.state string اختصار ولاية مكوّن من حرفَين أمريكيَين للعنوان
state[].electionAdministrationBody.physicalAddress.zip string تمثّل هذه السمة الرمز البريدي في الولايات المتحدة للعنوان.
state[].electionAdministrationBody.electionOfficials[] list مسؤولو الانتخابات في هذه الهيئة الإدارية للانتخابات.
state[].electionAdministrationBody.electionOfficials[].name string الاسم الكامل للمسؤول الانتخابي
state[].electionAdministrationBody.electionOfficials[].title string مسمّى مسؤول الانتخابات
state[].electionAdministrationBody.electionOfficials[].officePhoneNumber string رقم هاتف مكتب مسؤول الانتخابات
state[].electionAdministrationBody.electionOfficials[].faxNumber string رقم الفاكس الخاص بمسؤول الانتخابات
state[].electionAdministrationBody.electionOfficials[].emailAddress string عنوان البريد الإلكتروني لمسؤول الانتخابات
state[].local_jurisdiction nested object المدينة أو المقاطعة التي توفر معلومات الانتخابات لهذا الناخب. يمكن أن يحتوي هذا الكائن على نفس عناصر الحالة.
state[].sources[] list قائمة بالمصادر لهذه المنطقة وإذا تم سرد عدة مصادر، يكون قد تم تجميع البيانات من هذه المصادر.
state[].sources[].name string اسم مصدر البيانات.
state[].sources[].official boolean ما إذا كانت هذه البيانات واردة من مصدر حكومي رسمي

تجربة