تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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
}

اسم الموقع	القيمة	الوصف
`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`	لتحديد ما إذا كان الناخبون في الدائرة يصوتون فقط عبر البريد العادي (مع خيار محتمل لسحب الاقتراع أيضًا).

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

اسم الموقع	القيمة	الوصف
`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`	ما إذا كانت هذه البيانات مصدرها جهة حكومية رسمية

المسابقات

اسم الموقع	القيمة	الوصف
`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 في مجلس الشيوخ للولاية هو "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`	رقم هاتف Voice الخاص بمكتب حملة المرشّح.
`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`	ما إذا كانت هذه البيانات مصدرها جهة حكومية رسمية

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

اسم الموقع	القيمة	الوصف
`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`	ما إذا كانت هذه البيانات مصدرها جهة حكومية رسمية