Elections: voterInfoQuery

Tra cứu thông tin liên quan đến cử tri dựa trên địa chỉ đã đăng ký của cử tri. Thử ngay.

Thông tin được trả về có thể bao gồm

• Địa điểm bỏ phiếu (bao gồm cả các địa điểm bỏ phiếu sớm) cho một địa chỉ đường phố của khu dân cư
• Thông tin về cuộc thi và ứng cử viên
• Thông tin chính thức về bầu cử

Yêu cầu

Yêu cầu HTTP

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

Tham số

Tên thông số	Giá trị	Nội dung mô tả
Tham số truy vấn bắt buộc
address	string	Địa chỉ đã đăng ký của cử tri để tra cứu.
Tham số truy vấn không bắt buộc
electionId	long	Mã nhận dạng duy nhất của cuộc bầu cử để tra cứu. Bạn có thể lấy danh sách mã bầu cử tại https://www.googleapis.com/bầu cử dân sự/{version}/elections. Nếu không có mã bầu cử nào được chỉ định trong truy vấn và có nhiều cuộc bầu cử có dữ liệu về cử tri cụ thể, thì các cuộc bầu cử bổ sung sẽ được cung cấp trong trường phản hồi otherElections. Nếu không có cuộc bầu cử trực tiếp nào cho địa chỉ cử tri đã cung cấp, thì phản hồi chỉ trả về dữ liệu nếu mã bầu cử đã được chỉ định. Trong trường hợp này, bất kỳ công cụ nào cũng nên đưa ra truy vấn thứ hai với mã bầu cử được chỉ định để đảm bảo cung cấp đúng địa điểm bỏ phiếu, cuộc thi và thông tin chính thức về bầu cử (nếu có) cho người dùng.
officialOnly	boolean	Nếu bạn đặt chính sách này thành true (đúng), thì chỉ dữ liệu từ các nguồn chính thức của nhà nước sẽ được trả về. (Mặc định: false)

Nội dung yêu cầu

Không cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:

{
  "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
}

Tên tài sản	Giá trị	Nội dung mô tả	Ghi chú
kind	string	Xác định loại tài nguyên này. Giá trị: chuỗi cố định "civicinfo#voterInfoResponse".
election	nested object	Cuộc bầu cử được truy vấn.
otherElections[]	list	Khi có nhiều cuộc bầu cử cho địa chỉ của cử tri, trường otherElections sẽ được điền sẵn trong phản hồi của API và có hai khả năng: 1. Nếu những cuộc bầu cử này diễn ra vào các ngày khác nhau, API sẽ trả về thông tin bỏ phiếu của cuộc bầu cử đầu tiên/sớm nhất. Nếu cuộc bầu cử sớm nhất không phải là cuộc bầu cử dự kiến, hãy chỉ định mã bầu cử của cuộc bầu cử mong muốn trong yêu cầu API thứ hai bằng cách sử dụng trường electionId. 2. Nếu những cuộc bầu cử này diễn ra vào cùng ngày, API sẽ không trả về bất kỳ địa điểm bỏ phiếu, cuộc thi hoặc thông tin chính thức bầu cử nào để đảm bảo rằng ứng dụng sẽ đưa ra truy vấn bổ sung. Đối với các ứng dụng dành cho người dùng, bạn nên hiển thị những lựa chọn này để người dùng dễ phân biệt. Bạn nên gửi yêu cầu API thứ hai bằng trường electionId cho cuộc bầu cử phù hợp với người dùng.
normalizedInput	nested object	Phiên bản chuẩn hoá của địa chỉ được yêu cầu
normalizedInput.locationName	string	Tên của vị trí.
normalizedInput.line1	string	Tên đường phố và số của địa chỉ này.
normalizedInput.line2	string	Dòng thứ hai ghi địa chỉ, nếu cần.
normalizedInput.line3	string	Dòng địa chỉ thứ ba, nếu cần.
normalizedInput.city	string	Thành phố hoặc thị trấn của địa chỉ.
normalizedInput.state	string	Tên viết tắt của địa chỉ theo tiểu bang gồm hai chữ cái của Hoa Kỳ.
normalizedInput.zip	string	Mã bưu chính của Hoa Kỳ của địa chỉ.
mailOnly	boolean	Chỉ định liệu cử tri trong khu vực bầu cử chỉ bỏ phiếu bằng cách gửi phiếu bầu qua thư (cũng có thể chọn bỏ phiếu bầu).

Địa điểm bỏ phiếu, địa điểm bỏ phiếu sớm và địa điểm bỏ phiếu

Tên tài sản	Giá trị	Nội dung mô tả	Ghi chú
pollingLocations[]	list	Địa điểm mà cử tri đủ điều kiện bỏ phiếu vào ngày bầu cử.
pollingLocations[].address	nested object	Địa chỉ của vị trí.
pollingLocations[].address.locationName	string	Tên của vị trí.
pollingLocations[].address.line1	string	Tên đường phố và số của địa chỉ này.
pollingLocations[].address.line2	string	Dòng thứ hai ghi địa chỉ, nếu cần.
pollingLocations[].address.line3	string	Dòng địa chỉ thứ ba, nếu cần.
pollingLocations[].address.city	string	Thành phố hoặc thị trấn của địa chỉ.
pollingLocations[].address.state	string	Tên viết tắt của địa chỉ theo tiểu bang gồm hai chữ cái của Hoa Kỳ.
pollingLocations[].address.zip	string	Mã bưu chính của Hoa Kỳ của địa chỉ.
pollingLocations[].notes	string	Ghi chú về vị trí này (ví dụ: đường dốc hỗ trợ người khuyết tật hoặc lối vào sử dụng).
pollingLocations[].pollingHours	string	Nội dung mô tả về thời điểm vị trí này mở cửa.
pollingLocations[].name	string	Tên của địa điểm bỏ phiếu sớm hoặc địa điểm bỏ phiếu. Trường này không được điền sẵn cho địa điểm bỏ phiếu.
pollingLocations[].voterServices	string	Các dịch vụ do trang web bỏ phiếu sớm hoặc địa điểm bỏ phiếu này cung cấp. Trường này không được điền sẵn cho địa điểm bỏ phiếu.
pollingLocations[].startDate	string	Ngày đầu tiên có thể sử dụng trang web bỏ phiếu sớm hoặc địa điểm bỏ phiếu sớm này. Trường này không được điền sẵn cho địa điểm bỏ phiếu.
pollingLocations[].endDate	string	Ngày cuối cùng mà trang web bỏ phiếu sớm hoặc địa điểm bỏ phiếu này có thể được sử dụng. Trường này không được điền sẵn cho địa điểm bỏ phiếu.
pollingLocations[].latitude	string	Vĩ độ của vị trí, theo độ bắc của đường xích đạo. Xin lưu ý rằng trường này có thể không áp dụng cho một số địa điểm.
pollingLocations[].longitude	string	Kinh độ của vị trí, theo độ đông của Kinh tuyến gốc. Xin lưu ý rằng trường này có thể không áp dụng cho một số địa điểm.
pollingLocations[].sources[]	list	Danh sách các nguồn cho vị trí này. Nếu có nhiều nguồn, dữ liệu đã được tổng hợp từ các nguồn đó.
pollingLocations[].sources[].name	string	Tên của nguồn dữ liệu.
pollingLocations[].sources[].official	boolean	Liệu dữ liệu này có xuất phát từ nguồn chính thức của chính phủ hay không.
earlyVoteSites[]	list	Địa điểm mà cử tri đủ điều kiện bỏ phiếu sớm, trước ngày bầu cử.
earlyVoteSites[].address	nested object	Địa chỉ của vị trí.
earlyVoteSites[].address.locationName	string	Tên của vị trí.
earlyVoteSites[].address.line1	string	Tên đường phố và số của địa chỉ này.
earlyVoteSites[].address.line2	string	Dòng thứ hai ghi địa chỉ, nếu cần.
earlyVoteSites[].address.line3	string	Dòng địa chỉ thứ ba, nếu cần.
earlyVoteSites[].address.city	string	Thành phố hoặc thị trấn của địa chỉ.
earlyVoteSites[].address.state	string	Tên viết tắt của địa chỉ theo tiểu bang gồm hai chữ cái của Hoa Kỳ.
earlyVoteSites[].address.zip	string	Mã bưu chính của Hoa Kỳ của địa chỉ.
earlyVoteSites[].notes	string	Ghi chú về vị trí này (ví dụ: đường dốc hỗ trợ người khuyết tật hoặc lối vào sử dụng).
earlyVoteSites[].pollingHours	string	Nội dung mô tả về thời điểm vị trí này mở cửa.
earlyVoteSites[].name	string	Tên của địa điểm bỏ phiếu sớm hoặc địa điểm bỏ phiếu. Trường này không được điền sẵn cho địa điểm bỏ phiếu.
earlyVoteSites[].voterServices	string	Các dịch vụ do trang web bỏ phiếu sớm hoặc địa điểm bỏ phiếu này cung cấp. Trường này không được điền sẵn cho địa điểm bỏ phiếu.
earlyVoteSites[].startDate	string	Ngày đầu tiên có thể sử dụng trang web bỏ phiếu sớm hoặc địa điểm bỏ phiếu sớm này. Trường này không được điền sẵn cho địa điểm bỏ phiếu.
earlyVoteSites[].endDate	string	Ngày cuối cùng mà trang web bỏ phiếu sớm hoặc địa điểm bỏ phiếu này có thể được sử dụng. Trường này không được điền sẵn cho địa điểm bỏ phiếu.
earlyVoteSites[].latitude	string	Vĩ độ của vị trí, theo độ bắc của đường xích đạo. Xin lưu ý rằng trường này có thể không áp dụng cho một số địa điểm.
earlyVoteSites[].longitude	string	Kinh độ của vị trí, theo độ đông của Kinh tuyến gốc. Xin lưu ý rằng trường này có thể không áp dụng cho một số địa điểm.
earlyVoteSites[].sources[]	list	Danh sách các nguồn cho vị trí này. Nếu có nhiều nguồn, dữ liệu đã được tổng hợp từ các nguồn đó.
earlyVoteSites[].sources[].name	string	Tên của nguồn dữ liệu.
earlyVoteSites[].sources[].official	boolean	Liệu dữ liệu này có xuất phát từ nguồn chính thức của chính phủ hay không.
dropOffLocations[]	list	Địa điểm nơi cử tri đủ điều kiện bỏ phiếu bầu đã hoàn chỉnh. Cử tri phải nhận được và hoàn thành phiếu bầu trước khi đến địa điểm đó. Địa điểm có thể không có phiếu bầu trong khuôn viên. Những địa điểm này có thể mở cửa vào hoặc trước ngày bầu cử như được nêu trong trường địa điểm bỏ phiếu.
dropOffLocations[].address	nested object	Địa chỉ của vị trí.
dropOffLocations[].address.locationName	string	Tên của vị trí.
dropOffLocations[].address.line1	string	Tên đường phố và số của địa chỉ này.
dropOffLocations[].address.line2	string	Dòng thứ hai ghi địa chỉ, nếu cần.
dropOffLocations[].address.line3	string	Dòng địa chỉ thứ ba, nếu cần.
dropOffLocations[].address.city	string	Thành phố hoặc thị trấn của địa chỉ.
dropOffLocations[].address.state	string	Tên viết tắt của địa chỉ theo tiểu bang gồm hai chữ cái của Hoa Kỳ.
dropOffLocations[].address.zip	string	Mã bưu chính của Hoa Kỳ của địa chỉ.
dropOffLocations[].notes	string	Ghi chú về vị trí này (ví dụ: đường dốc hỗ trợ người khuyết tật hoặc lối vào sử dụng).
dropOffLocations[].pollingHours	string	Nội dung mô tả về thời điểm vị trí này mở cửa.
dropOffLocations[].name	string	Tên của địa điểm bỏ phiếu sớm hoặc địa điểm bỏ phiếu. Trường này không được điền sẵn cho địa điểm bỏ phiếu.
dropOffLocations[].voterServices	string	Các dịch vụ do trang web bỏ phiếu sớm hoặc địa điểm bỏ phiếu này cung cấp. Trường này không được điền sẵn cho địa điểm bỏ phiếu.
dropOffLocations[].startDate	string	Ngày đầu tiên có thể sử dụng trang web bỏ phiếu sớm hoặc địa điểm bỏ phiếu sớm này. Trường này không được điền sẵn cho địa điểm bỏ phiếu.
dropOffLocations[].endDate	string	Ngày cuối cùng mà trang web bỏ phiếu sớm hoặc địa điểm bỏ phiếu này có thể được sử dụng. Trường này không được điền sẵn cho địa điểm bỏ phiếu.
dropOffLocations[].latitude	string	Vĩ độ của vị trí, theo độ bắc của đường xích đạo. Xin lưu ý rằng trường này có thể không áp dụng cho một số địa điểm.
dropOffLocations[].longitude	string	Kinh độ của vị trí, theo độ đông của Kinh tuyến gốc. Xin lưu ý rằng trường này có thể không áp dụng cho một số địa điểm.
dropOffLocations[].sources[]	list	Danh sách các nguồn cho vị trí này. Nếu có nhiều nguồn, dữ liệu đã được tổng hợp từ các nguồn đó.
dropOffLocations[].sources[].name	string	Tên của nguồn dữ liệu.
dropOffLocations[].sources[].official	boolean	Liệu dữ liệu này có xuất phát từ nguồn chính thức của chính phủ hay không.

Cuộc thi

Tên tài sản	Giá trị	Nội dung mô tả	Ghi chú
contests[]	list	Các cuộc thi sẽ xuất hiện trên phiếu bầu của cử tri.
contests[].type	string	Loại cuộc thi. Thường thì mức giá này sẽ là "Chung", "Chính" hoặc "Loạt chương trình" đối với các cuộc thi có ứng viên. Đối với trưng cầu dân ý, đây sẽ là 'Trưng cầu dân ý'.
contests[].primaryParty	string	Nếu đây là một cuộc bầu cử của người ủng hộ, thì tên của đảng đó là cuộc bầu cử.
contests[].electorateSpecifications	string	Nội dung mô tả về mọi điều kiện bổ sung để bỏ phiếu trong cuộc thi này.
contests[].special	string	"Có" hoặc "Không" tuỳ thuộc vào việc cuộc thi này có được tổ chức ngoài chu kỳ bầu cử thông thường hay không.
contests[].ballotTitle	string	Tiêu đề chính thức trên phiếu bầu của cuộc thi này (nếu có).
contests[].office	string	Tên văn phòng của cuộc thi này.
contests[].level[]	list	Các cấp chính phủ mà văn phòng tham gia cuộc thi này. Có thể có nhiều cơ chế trong trường hợp một khu vực tài phán hoạt động hiệu quả ở hai cấp chính quyền khác nhau. Ví dụ: thị trưởng Quận Columbia hành động ở cấp locality nhưng cũng có hiệu lực ở cả administrativeArea2 và administrativeArea1. Các giá trị hợp lệ bao gồm:  international – Các chính phủ quốc tế, chẳng hạn như Liên Hợp Quốc hoặc Liên minh Châu Âu. country -- Chính phủ cấp quốc gia, chẳng hạn như Chính phủ Liên bang Hoa Kỳ. administrativeArea1 -- Các chính phủ của đơn vị hành chính cấp cao nhất của một quốc gia, chẳng hạn như các tiểu bang của Hoa Kỳ. regional -- Các chính quyền khu vực có thẩm quyền tài phán có thể vượt qua các phân khu hành chính tiêu chuẩn. Đây là trường hợp không phổ biến ở Hoa Kỳ nhưng phổ biến ở các thành phố lớn ở các quốc gia khác. administrativeArea2 -- Các chính phủ của phân khu hành chính cấp hai của một quốc gia, chẳng hạn như các hạt của Hoa Kỳ. locality -- Chính quyền thành phố hoặc thành phố. subLocality1 -- Các chính quyền của phân khu hành chính cấp cao nhất của thành phố, chẳng hạn như các phường của Washington, DC. subLocality2 -- Các chính quyền của phân khu hành chính cấp hai của một thành phố,chẳng hạn như Hội đồng khu vực tư vấn của Washington, DC. special -- Các quận địa phương chỉ dành cho các chính phủ có mục đích đặc biệt, chẳng hạn như các quận bảo tồn đất và nước.
contests[].roles[]	list	Các vai trò của văn phòng trong cuộc thi này. Vai trò không phải là toàn bộ vai trò hoặc để xác định chính xác toàn bộ trách nhiệm của một văn phòng cụ thể, mà chỉ là những danh mục sơ bộ giúp bạn dễ dàng lựa chọn hoặc sắp xếp danh sách văn phòng. Các giá trị hợp lệ bao gồm: headOfState -- Chính đại diện công cộng của một chính phủ. Người đứng đầu nhà nước của một quốc gia thường được gọi là Tổng thống. headOfGovernment -- Giám đốc điều hành của một chính phủ. Ở Hoa Kỳ, đây là Tổng thống; ở các quốc gia khác, người đó thường là Thủ tướng. Ở cấp thấp hơn, đây có thể là thống đốc hoặc thị trưởng. deputyHeadOfGovernment -- Nhân viên chịu trách nhiệm đảm nhận vai trò người đứng đầu chính phủ trong trường hợp người đứng đầu chính phủ được bầu qua đời hoặc không có năng lực. Ở Hoa Kỳ, đây là Phó tổng thống. Văn phòng này cũng có thể có các nhiệm vụ khác. governmentOfficer -- Một viên chức cấp điều hành được bầu. Ở các tiểu bang của Hoa Kỳ, đây có thể là các vai trò như tổng luật sư, người kiểm duyệt, thư ký hoặc nhân viên tiểu bang hoặc thủ quỹ. executiveCouncil -- Một thành viên của hội đồng điều hành đảm nhiệm vai trò của ban điều hành trong một nhóm. Ví dụ bao gồm uỷ viên của hạt ở Ấn Độ. legislatorUpperBody -- Là một thành viên thuộc phe trên của cơ quan lập pháp lưỡng viện hoặc cơ quan duy nhất của cơ quan lập pháp đơn viện. legislatorLowerBody -- Một thành viên ở cơ quan dưới của cơ quan lập pháp lưỡng viện. highestCourtJudge -- Thẩm phán của toà án cấp cao nhất của một chính phủ cụ thể, chẳng hạn như Toà án tối cao của tiểu bang. judge -- Thẩm phán của bất kỳ toà án nào không phải là toà án cấp cao nhất của chính phủ mà toà án đó phục vụ. schoolBoard -- Thành viên của một hội đồng trường học tại địa phương. specialPurposeOfficer -- Một viên chức thực hiện một mục đích duy nhất và xác định, chẳng hạn như thành viên của hội đồng bảo tồn đất và nước hoặc chuyên viên diệt muỗi.
contests[].district	nested object	Thông tin về khu vực bầu cử nơi diễn ra cuộc thi này.
contests[].district.name	string	Tên của quận.
contests[].district.scope	string	Phạm vi địa lý của quận này. Nếu không xác định được vị trí địa lý của quận nếu chưa chỉ định. Một trong các lựa chọn sau: quốc gia, toàn tiểu bang, quốc hội, stateUpper, state "cityCouncil" "citywide" "congressional" "countyCouncil" "countywide" "judicial" "national" "schoolBoard" "special" "stateLower" "stateUpper" "statewide" "township" "ward"
contests[].district.id	string	Giá trị nhận dạng cho học khu này, tương ứng với phạm vi của quận. Ví dụ: quận Thượng viện tiểu bang thứ 34 sẽ có mã nhận dạng là "34" và phạm vi là stateUpper.
contests[].numberElected	long	Số lượng ứng viên sẽ được bầu vào chức vụ trong cuộc tranh cử này.
contests[].numberVotingFor	long	Số ứng cử viên mà cử tri có thể bỏ phiếu trong cuộc tranh cử này.
contests[].ballotPlacement	long	Số chỉ định vị trí của cuộc tranh cử này trên phiếu bầu của cử tri.
contests[].candidates[]	list	Các lựa chọn ứng cử viên cho cuộc thi này.
contests[].candidates[].name	string	Tên của ứng viên.
contests[].candidates[].party	string	Tên đầy đủ của đảng mà ứng cử viên là thành viên.
contests[].candidates[].candidateUrl	string	URL cho trang web về chiến dịch của ứng cử viên.
contests[].candidates[].phone	string	Số điện thoại thoại của văn phòng chiến dịch của ứng cử viên.
contests[].candidates[].photoUrl	string	URL ảnh về ứng cử viên đó.
contests[].candidates[].email	string	Địa chỉ email của chiến dịch của ứng viên.
contests[].candidates[].orderOnBallot	long	Thứ tự mà ứng cử viên xuất hiện trên phiếu bầu trong cuộc tranh cử này.
contests[].candidates[].channels[]	list	Danh sách các kênh truyền thông (mạng xã hội) đã biết của ứng cử viên này.
contests[].candidates[].channels[].type	string	Loại kênh. Dưới đây là danh sách các loại kênh nhưng chưa đầy đủ. Chúng tôi có thể thêm các loại kênh khác sau. Một trong các độ phân giải: GooglePlus YouTube Facebook Twitter
contests[].candidates[].channels[].id	string	Giá trị nhận dạng công khai duy nhất cho kênh của ứng cử viên.
contests[].referendumTitle	string	Tiêu đề của cuộc trưng cầu dân ý (ví dụ: 'Đề xuất 42'). Trường này chỉ được điền cho các cuộc thi thuộc loại 'Trưng cầu dân ý'.
contests[].referendumSubtitle	string	Nội dung mô tả ngắn gọn về cuộc trưng cầu dân ý. Trường này chỉ được điền cho các cuộc thi thuộc loại 'Trưng cầu dân ý'.
contests[].referendumUrl	string	Đường liên kết đến cuộc trưng cầu dân ý. Trường này chỉ được điền cho các cuộc thi thuộc loại 'Trưng cầu dân ý'.
contests[].referendumBrief	string	Nêu một bản tóm tắt ngắn gọn về cuộc trưng cầu dân ý thường có trên phiếu bầu, bên dưới tiêu đề nhưng nằm phía trên văn bản. Trường này chỉ được điền cho các cuộc thi thuộc loại 'Trưng cầu dân ý'.
contests[].referendumText	string	Toàn bộ nội dung của cuộc trưng cầu dân ý. Trường này chỉ được điền cho các cuộc thi thuộc loại 'Trưng cầu dân ý'.
contests[].referendumProStatement	string	Một tuyên bố ủng hộ cuộc trưng cầu dân ý. Nội dung này không nhất thiết phải xuất hiện trên phiếu bầu. Trường này chỉ được điền cho các cuộc thi thuộc loại 'Trưng cầu dân ý'.
contests[].referendumConStatement	string	Một tuyên bố phản đối cuộc trưng cầu dân ý. Nội dung này không nhất thiết phải xuất hiện trên phiếu bầu. Trường này chỉ được điền cho các cuộc thi thuộc loại 'Trưng cầu dân ý'.
contests[].referendumPassageThreshold	string	Ngưỡng số phiếu mà cuộc trưng cầu dân ý cần có để thông qua, ví dụ: "hai phần ba". Trường này chỉ được điền cho các cuộc thi thuộc loại 'Trưng cầu dân ý'.
contests[].referendumEffectOfAbstain	string	Xác định ảnh hưởng của việc từ chối (không biểu quyết) đối với tuyên bố (tức là việc bỏ phiếu có được coi là bỏ phiếu phản đối hay không). Trường này chỉ được điền cho các cuộc thi thuộc loại 'Trưng cầu dân ý'.
contests[].referendumBallotResponses[]	list	Tập hợp các phản hồi bỏ phiếu cho cuộc trưng cầu dân ý. Một phản hồi phiếu bầu đại diện cho một dòng trên phiếu bầu. Các ví dụ thường gặp có thể bao gồm "có" hoặc "không" cho trưng cầu dân ý, hoặc tên của giám khảo cho cuộc thi giữ lại dữ liệu. Trường này chỉ được điền cho các cuộc thi thuộc loại 'Trưng cầu dân ý'.
contests[].sources[]	list	Danh sách các nguồn của cuộc thi này. Nếu có nhiều nguồn, thì dữ liệu đã được tổng hợp từ các nguồn đó.
contests[].sources[].name	string	Tên của nguồn dữ liệu.
contests[].sources[].official	boolean	Liệu dữ liệu này có xuất phát từ nguồn chính thức của chính phủ hay không.

Quan chức bầu cử

Tên tài sản	Giá trị	Nội dung mô tả	Ghi chú
state[]	list	Thông tin bầu cử của địa phương cho tiểu bang mà cử tri bỏ phiếu. Đối với Hoa Kỳ, mảng này sẽ chỉ có một phần tử.
state[].name	string	Tên khu vực tài phán.
state[].electionAdministrationBody	nested object	Cơ quan hành chính bầu cử cho khu vực này.
state[].electionAdministrationBody.name	string	Tên của cơ quan hành chính bầu cử này.
state[].electionAdministrationBody.electionInfoUrl	string	URL do cơ quan hành chính này cung cấp để tra cứu thông tin tổng tuyển cử.
state[].electionAdministrationBody.electionRegistrationUrl	string	URL do cơ quan hành chính này cung cấp để tra cứu cách đăng ký bỏ phiếu.
state[].electionAdministrationBody.electionRegistrationConfirmationUrl	string	URL do cơ quan hành chính này cung cấp để xác nhận rằng cử tri đã đăng ký bỏ phiếu.
state[].electionAdministrationBody.electionNoticeText	string	Văn bản thông báo khẩn cấp hoặc phút cuối cùng do cơ quan quản trị này cung cấp.
state[].electionAdministrationBody.electionNoticeUrl	string	URL do cơ quan quản trị này cung cấp để cung cấp thêm thông tin liên quan đến thông báo khẩn cấp hoặc phút cuối.
state[].electionAdministrationBody.absenteeVotingInfoUrl	string	URL do cơ quan quản trị này cung cấp để cung cấp thông tin về việc bỏ phiếu vắng mặt.
state[].electionAdministrationBody.votingLocationFinderUrl	string	URL do cơ quan hành chính này cung cấp để tra cứu nơi bỏ phiếu.
state[].electionAdministrationBody.ballotInfoUrl	string	URL do cơ quan hành chính này cung cấp để cung cấp thông tin về cuộc thi cho cử tri.
state[].electionAdministrationBody.electionRulesUrl	string	URL do cơ quan hành chính này cung cấp để mô tả quy tắc bầu cử cho cử tri.
state[].electionAdministrationBody.voter_services[]	list	Nội dung mô tả về những dịch vụ mà cơ quan quản trị này có thể cung cấp.
state[].electionAdministrationBody.hoursOfOperation	string	Nội dung mô tả giờ làm việc của cơ quan hành chính này.
state[].electionAdministrationBody.correspondenceAddress	nested object	Địa chỉ gửi thư của cơ quan hành chính này.
state[].electionAdministrationBody.correspondenceAddress.locationName	string	Tên của vị trí.
state[].electionAdministrationBody.correspondenceAddress.line1	string	Tên đường phố và số của địa chỉ này.
state[].electionAdministrationBody.correspondenceAddress.line2	string	Dòng thứ hai ghi địa chỉ, nếu cần.
state[].electionAdministrationBody.correspondenceAddress.line3	string	Dòng địa chỉ thứ ba, nếu cần.
state[].electionAdministrationBody.correspondenceAddress.city	string	Thành phố hoặc thị trấn của địa chỉ.
state[].electionAdministrationBody.correspondenceAddress.state	string	Tên viết tắt của địa chỉ theo tiểu bang gồm hai chữ cái của Hoa Kỳ.
state[].electionAdministrationBody.correspondenceAddress.zip	string	Mã bưu chính của Hoa Kỳ của địa chỉ.
state[].electionAdministrationBody.physicalAddress	nested object	Địa chỉ thực tế của cơ quan hành chính này.
state[].electionAdministrationBody.physicalAddress.locationName	string	Tên của vị trí.
state[].electionAdministrationBody.physicalAddress.line1	string	Tên đường phố và số của địa chỉ này.
state[].electionAdministrationBody.physicalAddress.line2	string	Dòng thứ hai ghi địa chỉ, nếu cần.
state[].electionAdministrationBody.physicalAddress.line3	string	Dòng địa chỉ thứ ba, nếu cần.
state[].electionAdministrationBody.physicalAddress.city	string	Thành phố hoặc thị trấn của địa chỉ.
state[].electionAdministrationBody.physicalAddress.state	string	Tên viết tắt của địa chỉ theo tiểu bang gồm hai chữ cái của Hoa Kỳ.
state[].electionAdministrationBody.physicalAddress.zip	string	Mã bưu chính của Hoa Kỳ của địa chỉ.
state[].electionAdministrationBody.electionOfficials[]	list	Quan chức bầu cử của cơ quan hành chính bầu cử này.
state[].electionAdministrationBody.electionOfficials[].name	string	Tên đầy đủ của quan chức bầu cử.
state[].electionAdministrationBody.electionOfficials[].title	string	Chức danh của quan chức bầu cử.
state[].electionAdministrationBody.electionOfficials[].officePhoneNumber	string	Số điện thoại văn phòng của quan chức bầu cử.
state[].electionAdministrationBody.electionOfficials[].faxNumber	string	Số fax của viên chức bầu cử.
state[].electionAdministrationBody.electionOfficials[].emailAddress	string	Địa chỉ email của quan chức bầu cử.
state[].local_jurisdiction	nested object	Thành phố hoặc hạt cung cấp thông tin bầu cử cho cử tri này. Đối tượng này có thể có cùng các phần tử với trạng thái.
state[].sources[]	list	Danh sách các nguồn cho khu vực này. Nếu có nhiều nguồn, dữ liệu đã được tổng hợp từ các nguồn đó.
state[].sources[].name	string	Tên của nguồn dữ liệu.
state[].sources[].official	boolean	Liệu dữ liệu này có xuất phát từ nguồn chính thức của chính phủ hay không.

Hãy dùng thử!