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 در پاسخ API پر می شود و دو احتمال وجود دارد: 1. اگر این انتخابات در روزهای مختلف رخ دهد، API اطلاعات رای گیری اولین/اولین انتخابات را برمی گرداند. اگر اولین انتخابات، انتخابات مورد نظر نیست، شناسه انتخاباتی انتخابات مورد نظر را در یک درخواست API دوم با استفاده از فیلد electionId مشخص کنید. 2. اگر این انتخابات در همان روز برگزار شود، API هیچ گونه اطلاعات مربوط به محل رأی گیری، رقابت، یا اطلاعات رسمی انتخابات را بر نمی گرداند تا اطمینان حاصل شود که درخواست اضافی انجام شده است. برای برنامه های کاربردی، توصیه می کنیم برای رفع ابهام، این انتخابات را به کاربر نمایش دهید. یک درخواست API دوم با استفاده از فیلد 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	نشانی وب سایت تبلیغاتی نامزد.
contests[].candidates[]. phone	string	شماره تلفن صوتی دفتر تبلیغاتی نامزد.
contests[].candidates[]. photoUrl	string	یک آدرس اینترنتی برای عکس نامزد.
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	نشانی اینترنتی ارائه شده توسط این نهاد اداری برای تأیید ثبت نام رأی دهنده برای رأی دادن.
state[].electionAdministrationBody. electionNoticeText	string	متن اطلاع رسانی لحظه آخری یا اضطراری ارائه شده توسط این نهاد اداری.
state[].electionAdministrationBody. electionNoticeUrl	string	نشانی اینترنتی ارائه شده توسط این نهاد اداری برای اطلاعات بیشتر مربوط به آخرین لحظه یا اعلان اضطراری.
state[].electionAdministrationBody. absenteeVotingInfoUrl	string	نشانی اینترنتی ارائه شده توسط این نهاد اداری برای اطلاع از رأی گیری غیابی.
state[].electionAdministrationBody. votingLocationFinderUrl	string	URL ارائه شده توسط این نهاد اداری برای جستجوی محل رای دادن.
state[].electionAdministrationBody. ballotInfoUrl	string	URL ارائه شده توسط این نهاد اداری برای دادن اطلاعات مسابقه به رای دهنده.
state[].electionAdministrationBody. electionRulesUrl	string	نشانی اینترنتی ارائه شده توسط این نهاد اداری که قوانین انتخابات را برای رای دهنده شرح می دهد.
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	آیا این داده ها از یک منبع رسمی دولتی آمده است.

آن را امتحان کنید!