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 trả về có thể bao gồm

• Địa điểm bỏ phiếu (bao gồm cả các điểm bỏ phiếu sớm) cho một địa chỉ đường phố dân cư cụ thể
• 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ị	Mô tả
Tham số truy vấn bắt buộc
address	string	Địa chỉ đã đăng ký của cử tri cần 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ử cần tra cứu. Bạn có thể lấy danh sách mã bầu cử tại https://www.googleapis.com/êu cách 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 cho cử tri nhất định, 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ì câu trả lời chỉ trả về dữ liệu nếu mã bầu cử được chỉ định. Trong trường hợp này, mọi công cụ nên đưa ra truy vấn thứ hai kèm theo mã bầu cử được chỉ định để đảm bảo cung cấp cho người dùng thông tin chính xác về địa điểm bỏ phiếu, cuộc thi và thông tin chính thức về bầu cử (nếu có).
officialOnly	boolean	Nếu bạn đặt chính sách này thành true, thì hệ thống sẽ chỉ trả về dữ liệu từ các nguồn chính thức của nhà nước. (Mặc định: false)

Nội dung yêu cầu

Đừ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ị	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 một địa chỉ cử tri, trường otherElections sẽ được điền sẵn trong phản hồi của API và có 2 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ử bạn 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 trong cùng một ngày, thì API sẽ không trả về bất kỳ thông tin nào về địa điểm bỏ phiếu, cuộc thi hoặc thông tin chính thức về cuộc bầu cử để đảm bảo người dùng thực hiện thêm truy vấn. Đối với các ứng dụng dành cho người dùng, bạn nên hiển thị các cuộc bầu cử này cho người dùng để làm rõ. Bạn phải gửi yêu cầu API thứ hai sử dụng trường electionId cho cuộc bầu cử có liên quan đến 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ố nhà 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 thứ ba của địa chỉ, nếu cần.
normalizedInput.city	string	Thành phố hoặc thị trấn đối với địa chỉ.
normalizedInput.state	string	Tên viết tắt của địa chỉ gồm hai chữ cái tại Hoa Kỳ.
normalizedInput.zip	string	Mã bưu chính Hoa Kỳ của địa chỉ.
mailOnly	boolean	Chỉ định xem cử tri trong khu vực chỉ bỏ phiếu bằng cách gửi phiếu bầu qua đường bưu điện hay không (bạn cũng có thể bỏ phiếu bằng cách bỏ phiếu).

Vị trí bỏ phiếu, vị trí bỏ phiếu sớm và vị trí bỏ phiếu

Tên tài sản	Giá trị	Mô tả	Ghi chú
pollingLocations[]	list	Các đị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ố nhà 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 thứ ba của địa chỉ, nếu cần.
pollingLocations[].address.city	string	Thành phố hoặc thị trấn đối với địa chỉ.
pollingLocations[].address.state	string	Tên viết tắt của địa chỉ gồm hai chữ cái tại Hoa Kỳ.
pollingLocations[].address.zip	string	Mã bưu chính Hoa Kỳ của địa chỉ.
pollingLocations[].notes	string	Các ghi chú về vị trí này (ví dụ: đoạn đường nối hỗ trợ người khuyết tật hoặc lối vào sẽ sử dụng).
pollingLocations[].pollingHours	string	Mô tả thời điểm vị trí này mở cửa.
pollingLocations[].name	string	Tên của trang web 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 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[].endDate	string	Ngày cuối cùng mà trang web bỏ phiếu sớm hoặc địa điểm trả hàng 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í, tính theo độ bắc của đường xích đạo. Lưu ý rằng trường này có thể không áp dụng cho một số vị trí.
pollingLocations[].longitude	string	Kinh độ của vị trí, theo độ đông của Kinh tuyến gốc. Lưu ý rằng trường này có thể không áp dụng cho một số vị trí.
pollingLocations[].sources[]	list	Danh sách các nguồn cho vị trí này. Nếu có nhiều nguồn được liệt kê thì 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ừ một nguồn chính thức của chính phủ hay không.
earlyVoteSites[]	list	Các địa điểm mà cử tri có đủ đ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ố nhà 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 thứ ba của địa chỉ, nếu cần.
earlyVoteSites[].address.city	string	Thành phố hoặc thị trấn đối với địa chỉ.
earlyVoteSites[].address.state	string	Tên viết tắt của địa chỉ gồm hai chữ cái tại Hoa Kỳ.
earlyVoteSites[].address.zip	string	Mã bưu chính Hoa Kỳ của địa chỉ.
earlyVoteSites[].notes	string	Các ghi chú về vị trí này (ví dụ: đoạn đường nối hỗ trợ người khuyết tật hoặc lối vào sẽ sử dụng).
earlyVoteSites[].pollingHours	string	Mô tả thời điểm vị trí này mở cửa.
earlyVoteSites[].name	string	Tên của trang web 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 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[].endDate	string	Ngày cuối cùng mà trang web bỏ phiếu sớm hoặc địa điểm trả hàng 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í, tính theo độ bắc của đường xích đạo. Lưu ý rằng trường này có thể không áp dụng cho một số vị trí.
earlyVoteSites[].longitude	string	Kinh độ của vị trí, theo độ đông của Kinh tuyến gốc. Lưu ý rằng trường này có thể không áp dụng cho một số vị trí.
earlyVoteSites[].sources[]	list	Danh sách các nguồn cho vị trí này. Nếu có nhiều nguồn được liệt kê thì 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ừ một nguồn chính thức của chính phủ hay không.
dropOffLocations[]	list	Các địa điểm mà cử tri đủ điều kiện để bỏ phiếu đã hoàn thành. Cử tri phải nhận 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 tại cơ sở. Các vị trí 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 pollhours.
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ố nhà 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 thứ ba của địa chỉ, nếu cần.
dropOffLocations[].address.city	string	Thành phố hoặc thị trấn đối với địa chỉ.
dropOffLocations[].address.state	string	Tên viết tắt của địa chỉ gồm hai chữ cái tại Hoa Kỳ.
dropOffLocations[].address.zip	string	Mã bưu chính Hoa Kỳ của địa chỉ.
dropOffLocations[].notes	string	Các ghi chú về vị trí này (ví dụ: đoạn đường nối hỗ trợ người khuyết tật hoặc lối vào sẽ sử dụng).
dropOffLocations[].pollingHours	string	Mô tả thời điểm vị trí này mở cửa.
dropOffLocations[].name	string	Tên của trang web 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 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[].endDate	string	Ngày cuối cùng mà trang web bỏ phiếu sớm hoặc địa điểm trả hàng 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í, tính theo độ bắc của đường xích đạo. Lưu ý rằng trường này có thể không áp dụng cho một số vị trí.
dropOffLocations[].longitude	string	Kinh độ của vị trí, theo độ đông của Kinh tuyến gốc. Lưu ý rằng trường này có thể không áp dụng cho một số vị trí.
dropOffLocations[].sources[]	list	Danh sách các nguồn cho vị trí này. Nếu có nhiều nguồn được liệt kê thì 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ừ mộ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ị	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ường, nhãn này sẽ là "Chung", "Chính" hoặc "Nhiều giá trị" cho các cuộc thi có ứng cử 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ử đảng phái, thì tên của đảng đượ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	Tên 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 cho cuộc thi này.
contests[].level[]	list	Các cấp chính phủ mà văn phòng của cuộc tranh cử này nắm giữ. Có thể có nhiều trường hợp mà một khu vực tài phán hành động hiệu quả ở hai cấp chính phủ khác nhau; ví dụ: Thị trưởng Đặc khu Columbia hành động ở cấp locality, nhưng cũng có hiệu quả ở cả cấp administrativeArea2 và administrativeArea1. Các giá trị hợp lệ bao gồm: international –- Các chính phủ quốc tế, 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 -- 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 -- Chính quyền khu vực có khu vực tài phán có thể vượt qua các phân khu hành chính tiêu chuẩn; những thông tin này không phổ biến ở Hoa Kỳ nhưng phổ biến quanh các thành phố lớn ở các quốc gia khác. administrativeArea2 -- Chính phủ của đơn vị 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 -- Chính quyền của đơn vị hành chính cấp cao nhất của một thành phố, chẳng hạn như các phường của Washington, DC. subLocality2 -- Chính phủ thuộc đơn vị hành chính cấp hai của một thành phố,chẳng hạn như Hội đồng cố vấn vùng lân cận của Washington, DC. special -- Các quận địa phương chỉ tồn tại cho các chính quyền chuyên biệt, chẳng hạn như khu bảo tồn đất và nước.
contests[].roles[]	list	Những vai trò mà văn phòng này xác định. Vai trò không phải là đầy đủ hoặc chỉ định chính xác toàn bộ trách nhiệm của một văn phòng nhất định mà chỉ là các danh mục gần đúng, hữu ích cho việc lựa chọn chung trong danh sách các chức vụ. Các giá trị hợp lệ bao gồm: headOfState -- Người đại diện công cộng của một chính phủ. Nguyên thủ quốc gia 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ỳ, đó là Tổng thống; ở các quốc gia khác, người đứng đầu thường là Thủ tướng. Ở cấp thấp hơn, đó có thể là thống đốc hoặc thị trưởng. deputyHeadOfGovernment -- Viên chức 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 mất quyền. Ở 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 giám đốc chi nhánh được bầu. Ở các tiểu bang của Hoa Kỳ, những vai trò này có thể bao gồm các vai trò như tổng chưởng lý, biên tập viên, thư ký hoặc tiểu bang hay thủ quỹ. executiveCouncil – – Thành viên của hội đồng điều hành đảm nhiệm các vai trò điều hành nhánh với tư cách là một nhóm. Ví dụ như uỷ viên của hạt thuộc bang Virginia. legislatorUpperBody -- Thành viên cơ quan 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 nhất 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ấp tiểu bang. judge -- Thẩm phán ở một toà án bất kỳ không phải là toà án cấp cao nhất của chính phủ mà nơi đó phục vụ. schoolBoard –- Thành viên của hội đồng trường học địa phương. specialPurposeOfficer -- Nhân viên phục vụ 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 nhân viên phòng chống muỗi.
contests[].district	nested object	Thông tin về khu vực bầu cử diễn ra cuộc thi.
contests[].district.name	string	Tên 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 khu vực địa lý của học khu. Một trong các lựa chọn sau: quốc gia, toàn tiểu bang, quốc hội, cấp tiểu bangCao, tiểu bang, toàn hạt, tư pháp, hội đồng trường học, toàn thành phố, thị trấn, hội đồng hạt, hội đồng thành phố, phường, đặc biệt Các giá trị được chấp nhận là: "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, theo phạm vi của học khu. Ví dụ: quận 34 Thượng viện tiểu bang sẽ có id "34" và phạm vi stateUpper.
contests[].numberElected	long	Số lượng ứng cử viên sẽ được bầu vào chức vụ trong cuộc thi này.
contests[].numberVotingFor	long	Số lượng ứng cử viên mà cử tri có thể bỏ phiếu trong cuộc tranh cử này.
contests[].ballotPlacement	long	Con 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 cử 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 trang web cho chiến dịch của ứng cử viên.
contests[].candidates[].phone	string	Số điện thoại gọi thoại cho văn phòng tranh cử của ứng cử viên.
contests[].candidates[].photoUrl	string	URL ảnh chụp ứng cử viên.
contests[].candidates[].email	string	Địa chỉ email cho chiến dịch của ứng cử 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 (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 trên 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 sẵn cho các cuộc tranh cử 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 sẵn cho các cuộc tranh cử 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 sẵn cho các cuộc tranh cử thuộc loại "Trưng cầu dân ý".
contests[].referendumBrief	string	Chỉ định một đoạn tóm tắt ngắn về cuộc trưng cầu dân ý mà thường có trên phiếu bầu, bên dưới tiêu đề nhưng ở phía trên nội dung. Trường này chỉ được điền sẵn cho các cuộc tranh cử thuộc loại "Trưng cầu dân ý".
contests[].referendumText	string	Nội dung đầy đủ của cuộc trưng cầu dân ý. Trường này chỉ được điền sẵn cho các cuộc tranh cử 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 ý. Thông tin này không nhất thiết xuất hiện trên phiếu bầu. Trường này chỉ được điền sẵn cho các cuộc tranh cử 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 ý. Thông tin này không nhất thiết xuất hiện trên phiếu bầu. Trường này chỉ được điền sẵn cho các cuộc tranh cử 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 sẵn cho các cuộc tranh cử thuộc loại "Trưng cầu dân ý".
contests[].referendumEffectOfAbstain	string	Nêu rõ tác động của việc bỏ phiếu (không bỏ phiếu) đối với tuyên bố (nghĩa là việc bỏ phiếu trắng có được coi là phản đối hay không). Trường này chỉ được điền sẵn cho các cuộc tranh cử 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 ý. Nội dung phản hồi trên phiếu bầu biểu thị 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 "no" cho trưng cầu dân ý hoặc tên của giám khảo cho một cuộc thi giữ lại dữ liệu. Trường này chỉ được điền sẵn cho các cuộc tranh cử thuộc loại "Trưng cầu dân ý".
contests[].sources[]	list	Danh sách các nguồn tham gia cuộc thi này. Nếu có nhiều nguồn được liệt kê, 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ừ mộ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ị	Mô tả	Ghi chú
state[]	list	Thông tin bầu cử tại địa phương cho tiểu bang mà cử tri bỏ phiếu. Đối với Hoa Kỳ, sẽ chỉ có một phần tử trong mảng này.
state[].name	string	Tên khu vực tài phán.
state[].electionAdministrationBody	nested object	Cơ quan quản lý 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	Nội dung thông báo phút chót hoặc thông báo khẩn cấp do cơ quan hành chính này cung cấp.
state[].electionAdministrationBody.electionNoticeUrl	string	URL do cơ quan hành chính 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 chót.
state[].electionAdministrationBody.absenteeVotingInfoUrl	string	URL do cơ quan hành chính 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 quản trị này cung cấp để tra cứu địa điểm 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, trong đó mô tả các quy tắc bầu cử dành cho cử tri.
state[].electionAdministrationBody.voter_services[]	list	Mô tả các dịch vụ mà cơ quan hành chính này có thể cung cấp.
state[].electionAdministrationBody.hoursOfOperation	string	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ố nhà 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 thứ ba của địa chỉ, nếu cần.
state[].electionAdministrationBody.correspondenceAddress.city	string	Thành phố hoặc thị trấn đối với địa chỉ.
state[].electionAdministrationBody.correspondenceAddress.state	string	Tên viết tắt của địa chỉ gồm hai chữ cái tại Hoa Kỳ.
state[].electionAdministrationBody.correspondenceAddress.zip	string	Mã bưu chính 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ố nhà 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 thứ ba của địa chỉ, nếu cần.
state[].electionAdministrationBody.physicalAddress.city	string	Thành phố hoặc thị trấn đối với địa chỉ.
state[].electionAdministrationBody.physicalAddress.state	string	Tên viết tắt của địa chỉ gồm hai chữ cái tại Hoa Kỳ.
state[].electionAdministrationBody.physicalAddress.zip	string	Mã bưu chính Hoa Kỳ của địa chỉ.
state[].electionAdministrationBody.electionOfficials[]	list	Đại diện quản lý 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 viên 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 quan chức bầu cử.
state[].electionAdministrationBody.electionOfficials[].emailAddress	string	Địa chỉ email của nhân viên 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ác phần tử tương tự như 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 được liệt kê thì 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ừ một nguồn chính thức của chính phủ hay không.

Hãy dùng thử!