// Copyright 2025 Google LLC.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

// Code generated file. DO NOT EDIT.

// Package civicinfo provides access to the Google Civic Information API.
//
// For product documentation, see: https://developers.google.com/civic-information/
//
// # Library status
//
// These client libraries are officially supported by Google. However, this
// library is considered complete and is in maintenance mode. This means
// that we will address critical bugs and security issues but will not add
// any new features.
//
// When possible, we recommend using our newer
// [Cloud Client Libraries for Go](https://pkg.go.dev/cloud.google.com/go)
// that are still actively being worked and iterated on.
//
// # Creating a client
//
// Usage example:
//
//	import "google.golang.org/api/civicinfo/v2"
//	...
//	ctx := context.Background()
//	civicinfoService, err := civicinfo.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for
// authentication. For information on how to create and obtain Application
// Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API
// keys), use [google.golang.org/api/option.WithAPIKey]:
//
//	civicinfoService, err := civicinfo.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth
// flow, use [google.golang.org/api/option.WithTokenSource]:
//
//	config := &oauth2.Config{...}
//	// ...
//	token, err := config.Exchange(ctx, ...)
//	civicinfoService, err := civicinfo.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See [google.golang.org/api/option.ClientOption] for details on options.
package civicinfo // import "google.golang.org/api/civicinfo/v2"

import (
	"bytes"
	"context"
	"encoding/json"
	"errors"
	"fmt"
	"io"
	"log/slog"
	"net/http"
	"net/url"
	"strconv"
	"strings"

	"github.com/googleapis/gax-go/v2/internallog"
	googleapi "google.golang.org/api/googleapi"
	internal "google.golang.org/api/internal"
	gensupport "google.golang.org/api/internal/gensupport"
	option "google.golang.org/api/option"
	internaloption "google.golang.org/api/option/internaloption"
	htransport "google.golang.org/api/transport/http"
)

// Always reference these packages, just in case the auto-generated code
// below doesn't.
var _ = bytes.NewBuffer
var _ = strconv.Itoa
var _ = fmt.Sprintf
var _ = json.NewDecoder
var _ = io.Copy
var _ = url.Parse
var _ = gensupport.MarshalJSON
var _ = googleapi.Version
var _ = errors.New
var _ = strings.Replace
var _ = context.Canceled
var _ = internaloption.WithDefaultEndpoint
var _ = internal.Version
var _ = internallog.New

const apiId = "civicinfo:v2"
const apiName = "civicinfo"
const apiVersion = "v2"
const basePath = "https://civicinfo.googleapis.com/"
const basePathTemplate = "https://civicinfo.UNIVERSE_DOMAIN/"
const mtlsBasePath = "https://civicinfo.mtls.googleapis.com/"

// NewService creates a new Service.
func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) {
	opts = append(opts, internaloption.WithDefaultEndpoint(basePath))
	opts = append(opts, internaloption.WithDefaultEndpointTemplate(basePathTemplate))
	opts = append(opts, internaloption.WithDefaultMTLSEndpoint(mtlsBasePath))
	opts = append(opts, internaloption.EnableNewAuthLibrary())
	client, endpoint, err := htransport.NewClient(ctx, opts...)
	if err != nil {
		return nil, err
	}
	s := &Service{client: client, BasePath: basePath, logger: internaloption.GetLogger(opts)}
	s.Divisions = NewDivisionsService(s)
	s.Elections = NewElectionsService(s)
	if endpoint != "" {
		s.BasePath = endpoint
	}
	return s, nil
}

// New creates a new Service. It uses the provided http.Client for requests.
//
// Deprecated: please use NewService instead.
// To provide a custom HTTP client, use option.WithHTTPClient.
// If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead.
func New(client *http.Client) (*Service, error) {
	if client == nil {
		return nil, errors.New("client is nil")
	}
	return NewService(context.TODO(), option.WithHTTPClient(client))
}

type Service struct {
	client    *http.Client
	logger    *slog.Logger
	BasePath  string // API endpoint base URL
	UserAgent string // optional additional User-Agent fragment

	Divisions *DivisionsService

	Elections *ElectionsService
}

func (s *Service) userAgent() string {
	if s.UserAgent == "" {
		return googleapi.UserAgent
	}
	return googleapi.UserAgent + " " + s.UserAgent
}

func NewDivisionsService(s *Service) *DivisionsService {
	rs := &DivisionsService{s: s}
	return rs
}

type DivisionsService struct {
	s *Service
}

func NewElectionsService(s *Service) *ElectionsService {
	rs := &ElectionsService{s: s}
	return rs
}

type ElectionsService struct {
	s *Service
}

type CivicinfoApiprotosV2DivisionByAddressResponse struct {
	Divisions map[string]CivicinfoSchemaV2GeographicDivision `json:"divisions,omitempty"`
	// NormalizedInput: The normalized version of the requested address.
	NormalizedInput *CivicinfoSchemaV2SimpleAddressType `json:"normalizedInput,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Divisions") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Divisions") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoApiprotosV2DivisionByAddressResponse) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoApiprotosV2DivisionByAddressResponse
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoApiprotosV2DivisionSearchResponse: The result of a division search
// query.
type CivicinfoApiprotosV2DivisionSearchResponse struct {
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "civicinfo#divisionSearchResponse".
	Kind    string                                      `json:"kind,omitempty"`
	Results []*CivicinfoApiprotosV2DivisionSearchResult `json:"results,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Kind") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Kind") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoApiprotosV2DivisionSearchResponse) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoApiprotosV2DivisionSearchResponse
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoApiprotosV2DivisionSearchResult: Represents a political geographic
// division that matches the requested query.
type CivicinfoApiprotosV2DivisionSearchResult struct {
	// Aliases: Other Open Civic Data identifiers that refer to the same division
	// -- for example, those that refer to other political divisions whose
	// boundaries are defined to be coterminous with this one. For example,
	// ocd-division/country:us/state:wy will include an alias of
	// ocd-division/country:us/state:wy/cd:1, since Wyoming has only one
	// Congressional district.
	Aliases []string `json:"aliases,omitempty"`
	// Name: The name of the division.
	Name string `json:"name,omitempty"`
	// OcdId: The unique Open Civic Data identifier for this division
	OcdId string `json:"ocdId,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Aliases") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Aliases") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoApiprotosV2DivisionSearchResult) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoApiprotosV2DivisionSearchResult
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoApiprotosV2ElectionsQueryResponse: The list of elections available
// for this version of the API.
type CivicinfoApiprotosV2ElectionsQueryResponse struct {
	// Elections: A list of available elections
	Elections []*CivicinfoSchemaV2Election `json:"elections,omitempty"`
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "civicinfo#electionsQueryResponse".
	Kind string `json:"kind,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Elections") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Elections") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoApiprotosV2ElectionsQueryResponse) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoApiprotosV2ElectionsQueryResponse
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoApiprotosV2VoterInfoResponse: The result of a voter info lookup
// query.
type CivicinfoApiprotosV2VoterInfoResponse struct {
	// Contests: Contests that will appear on the voter's ballot.
	Contests []*CivicinfoSchemaV2Contest `json:"contests,omitempty"`
	// DropOffLocations: Locations where a voter is eligible to drop off a
	// completed ballot. The voter must have received and completed a ballot prior
	// to arriving at the location. The location may not have ballots available on
	// the premises. These locations could be open on or before election day as
	// indicated in the pollingHours field.
	DropOffLocations []*CivicinfoSchemaV2PollingLocation `json:"dropOffLocations,omitempty"`
	// EarlyVoteSites: Locations where the voter is eligible to vote early, prior
	// to election day.
	EarlyVoteSites []*CivicinfoSchemaV2PollingLocation `json:"earlyVoteSites,omitempty"`
	// Election: The election that was queried.
	Election *CivicinfoSchemaV2Election `json:"election,omitempty"`
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "civicinfo#voterInfoResponse".
	Kind string `json:"kind,omitempty"`
	// MailOnly: Specifies whether voters in the precinct vote only by mailing
	// their ballots (with the possible option of dropping off their ballots as
	// well).
	MailOnly bool `json:"mailOnly,omitempty"`
	// NormalizedInput: The normalized version of the requested address
	NormalizedInput *CivicinfoSchemaV2SimpleAddressType `json:"normalizedInput,omitempty"`
	// OtherElections: When there are multiple elections for a voter address, the
	// otherElections field is populated in the API response and there are two
	// possibilities: 1. If the earliest election is not the intended election,
	// specify the election ID of the desired election in a second API request
	// using the electionId field. 2. If these elections occur on the same day, the
	// API doesn?t return any polling location, contest, or election official
	// information to ensure that an additional query is made. For user-facing
	// applications, we recommend displaying these elections to the user to
	// disambiguate. A second API request using the electionId field should be made
	// for the election that is relevant to the user.
	OtherElections []*CivicinfoSchemaV2Election `json:"otherElections,omitempty"`
	// PollingLocations: Locations where the voter is eligible to vote on election
	// day.
	PollingLocations []*CivicinfoSchemaV2PollingLocation `json:"pollingLocations,omitempty"`
	PrecinctId       string                              `json:"precinctId,omitempty"`
	// Precincts: The precincts that match this voter's address. Will only be
	// returned for project IDs which have been allowlisted as "partner projects".
	Precincts []*CivicinfoSchemaV2Precinct `json:"precincts,omitempty"`
	// State: Local Election Information for the state that the voter votes in. For
	// the US, there will only be one element in this array.
	State []*CivicinfoSchemaV2AdministrationRegion `json:"state,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Contests") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Contests") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoApiprotosV2VoterInfoResponse) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoApiprotosV2VoterInfoResponse
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoSchemaV2AdministrationRegion: Describes information about a
// regional election administrative area.
type CivicinfoSchemaV2AdministrationRegion struct {
	// ElectionAdministrationBody: The election administration body for this area.
	ElectionAdministrationBody *CivicinfoSchemaV2AdministrativeBody `json:"electionAdministrationBody,omitempty"`
	// LocalJurisdiction: The city or county that provides election information for
	// this voter. This object can have the same elements as state.
	LocalJurisdiction *CivicinfoSchemaV2AdministrationRegion `json:"local_jurisdiction,omitempty"`
	// Name: The name of the jurisdiction.
	Name string `json:"name,omitempty"`
	// Sources: A list of sources for this area. If multiple sources are listed the
	// data has been aggregated from those sources.
	Sources []*CivicinfoSchemaV2Source `json:"sources,omitempty"`
	// ForceSendFields is a list of field names (e.g. "ElectionAdministrationBody")
	// to unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "ElectionAdministrationBody") to
	// include in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoSchemaV2AdministrationRegion) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoSchemaV2AdministrationRegion
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoSchemaV2AdministrativeBody: Information about an election
// administrative body (e.g. County Board of Elections).
type CivicinfoSchemaV2AdministrativeBody struct {
	// AbsenteeVotingInfoUrl: A URL provided by this administrative body for
	// information on absentee voting.
	AbsenteeVotingInfoUrl string `json:"absenteeVotingInfoUrl,omitempty"`
	// BallotInfoUrl: A URL provided by this administrative body to give contest
	// information to the voter.
	BallotInfoUrl string `json:"ballotInfoUrl,omitempty"`
	// CorrespondenceAddress: The mailing address of this administrative body.
	CorrespondenceAddress *CivicinfoSchemaV2SimpleAddressType `json:"correspondenceAddress,omitempty"`
	// ElectionInfoUrl: A URL provided by this administrative body for looking up
	// general election information.
	ElectionInfoUrl string `json:"electionInfoUrl,omitempty"`
	// ElectionNoticeText: A last minute or emergency notification text provided by
	// this administrative body.
	ElectionNoticeText string `json:"electionNoticeText,omitempty"`
	// ElectionNoticeUrl: A URL provided by this administrative body for additional
	// information related to the last minute or emergency notification.
	ElectionNoticeUrl string `json:"electionNoticeUrl,omitempty"`
	// ElectionOfficials: The election officials for this election administrative
	// body.
	ElectionOfficials []*CivicinfoSchemaV2ElectionOfficial `json:"electionOfficials,omitempty"`
	// ElectionRegistrationConfirmationUrl: A URL provided by this administrative
	// body for confirming that the voter is registered to vote.
	ElectionRegistrationConfirmationUrl string `json:"electionRegistrationConfirmationUrl,omitempty"`
	// ElectionRegistrationUrl: A URL provided by this administrative body for
	// looking up how to register to vote.
	ElectionRegistrationUrl string `json:"electionRegistrationUrl,omitempty"`
	// ElectionRulesUrl: A URL provided by this administrative body describing
	// election rules to the voter.
	ElectionRulesUrl string `json:"electionRulesUrl,omitempty"`
	// HoursOfOperation: A description of the hours of operation for this
	// administrative body.
	HoursOfOperation string `json:"hoursOfOperation,omitempty"`
	// Name: The name of this election administrative body.
	Name string `json:"name,omitempty"`
	// PhysicalAddress: The physical address of this administrative body.
	PhysicalAddress *CivicinfoSchemaV2SimpleAddressType `json:"physicalAddress,omitempty"`
	// VoterServices: A description of the services this administrative body may
	// provide.
	VoterServices []string `json:"voter_services,omitempty"`
	// VotingLocationFinderUrl: A URL provided by this administrative body for
	// looking up where to vote.
	VotingLocationFinderUrl string `json:"votingLocationFinderUrl,omitempty"`
	// ForceSendFields is a list of field names (e.g. "AbsenteeVotingInfoUrl") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AbsenteeVotingInfoUrl") to
	// include in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoSchemaV2AdministrativeBody) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoSchemaV2AdministrativeBody
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoSchemaV2Candidate: Information about a candidate running for
// elected office.
type CivicinfoSchemaV2Candidate struct {
	// CandidateUrl: The URL for the candidate's campaign web site.
	CandidateUrl string `json:"candidateUrl,omitempty"`
	// Channels: A list of known (social) media channels for this candidate.
	Channels []*CivicinfoSchemaV2Channel `json:"channels,omitempty"`
	// Email: The email address for the candidate's campaign.
	Email string `json:"email,omitempty"`
	// Name: The candidate's name. If this is a joint ticket it will indicate the
	// name of the candidate at the top of a ticket followed by a / and that name
	// of candidate at the bottom of the ticket. e.g. "Mitt Romney / Paul Ryan"
	Name string `json:"name,omitempty"`
	// OrderOnBallot: The order the candidate appears on the ballot for this
	// contest.
	OrderOnBallot int64 `json:"orderOnBallot,omitempty,string"`
	// Party: The full name of the party the candidate is a member of.
	Party string `json:"party,omitempty"`
	// Phone: The voice phone number for the candidate's campaign office.
	Phone string `json:"phone,omitempty"`
	// PhotoUrl: A URL for a photo of the candidate.
	PhotoUrl string `json:"photoUrl,omitempty"`
	// ForceSendFields is a list of field names (e.g. "CandidateUrl") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "CandidateUrl") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoSchemaV2Candidate) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoSchemaV2Candidate
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoSchemaV2Channel: A social media or web channel for a candidate.
type CivicinfoSchemaV2Channel struct {
	// Id: The unique public identifier for the candidate's channel.
	Id string `json:"id,omitempty"`
	// Type: The type of channel. The following is a list of types of channels, but
	// is not exhaustive. More channel types may be added at a later time. One of:
	// GooglePlus, YouTube, Facebook, Twitter
	Type string `json:"type,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Id") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Id") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoSchemaV2Channel) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoSchemaV2Channel
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoSchemaV2Contest: Information about a contest that appears on a
// voter's ballot.
type CivicinfoSchemaV2Contest struct {
	// BallotPlacement: A number specifying the position of this contest on the
	// voter's ballot.
	BallotPlacement int64 `json:"ballotPlacement,omitempty,string"`
	// BallotTitle: The official title on the ballot for this contest, only where
	// available.
	BallotTitle string `json:"ballotTitle,omitempty"`
	// Candidates: The candidate choices for this contest.
	Candidates []*CivicinfoSchemaV2Candidate `json:"candidates,omitempty"`
	// District: Information about the electoral district that this contest is in.
	District *CivicinfoSchemaV2ElectoralDistrict `json:"district,omitempty"`
	// ElectorateSpecifications: A description of any additional eligibility
	// requirements for voting in this contest.
	ElectorateSpecifications string `json:"electorateSpecifications,omitempty"`
	// Level: The levels of government of the office for this contest. There may be
	// more than one in cases where a jurisdiction effectively acts at two
	// different levels of government; for example, the mayor of the District of
	// Columbia acts at "locality" level, but also effectively at both
	// "administrative-area-2" and "administrative-area-1".
	//
	// Possible values:
	//   "international"
	//   "country"
	//   "administrativeArea1"
	//   "regional"
	//   "administrativeArea2"
	//   "locality"
	//   "subLocality1"
	//   "subLocality2"
	//   "special"
	Level []string `json:"level,omitempty"`
	// NumberElected: The number of candidates that will be elected to office in
	// this contest.
	NumberElected int64 `json:"numberElected,omitempty,string"`
	// NumberVotingFor: The number of candidates that a voter may vote for in this
	// contest.
	NumberVotingFor int64 `json:"numberVotingFor,omitempty,string"`
	// Office: The name of the office for this contest.
	Office string `json:"office,omitempty"`
	// PrimaryParties: If this is a partisan election, the name of the
	// party/parties it is for.
	PrimaryParties []string `json:"primaryParties,omitempty"`
	// ReferendumBallotResponses: The set of ballot responses for the referendum. A
	// ballot response represents a line on the ballot. Common examples might
	// include "yes" or "no" for referenda. This field is only populated for
	// contests of type 'Referendum'.
	ReferendumBallotResponses []string `json:"referendumBallotResponses,omitempty"`
	// ReferendumBrief: Specifies a short summary of the referendum that is
	// typically on the ballot below the title but above the text. This field is
	// only populated for contests of type 'Referendum'.
	ReferendumBrief string `json:"referendumBrief,omitempty"`
	// ReferendumConStatement: A statement in opposition to the referendum. It does
	// not necessarily appear on the ballot. This field is only populated for
	// contests of type 'Referendum'.
	ReferendumConStatement string `json:"referendumConStatement,omitempty"`
	// ReferendumEffectOfAbstain: Specifies what effect abstaining (not voting) on
	// the proposition will have (i.e. whether abstaining is considered a vote
	// against it). This field is only populated for contests of type 'Referendum'.
	ReferendumEffectOfAbstain string `json:"referendumEffectOfAbstain,omitempty"`
	// ReferendumPassageThreshold: The threshold of votes that the referendum needs
	// in order to pass, e.g. "two-thirds". This field is only populated for
	// contests of type 'Referendum'.
	ReferendumPassageThreshold string `json:"referendumPassageThreshold,omitempty"`
	// ReferendumProStatement: A statement in favor of the referendum. It does not
	// necessarily appear on the ballot. This field is only populated for contests
	// of type 'Referendum'.
	ReferendumProStatement string `json:"referendumProStatement,omitempty"`
	// ReferendumSubtitle: A brief description of the referendum. This field is
	// only populated for contests of type 'Referendum'.
	ReferendumSubtitle string `json:"referendumSubtitle,omitempty"`
	// ReferendumText: The full text of the referendum. This field is only
	// populated for contests of type 'Referendum'.
	ReferendumText string `json:"referendumText,omitempty"`
	// ReferendumTitle: The title of the referendum (e.g. 'Proposition 42'). This
	// field is only populated for contests of type 'Referendum'.
	ReferendumTitle string `json:"referendumTitle,omitempty"`
	// ReferendumUrl: A link to the referendum. This field is only populated for
	// contests of type 'Referendum'.
	ReferendumUrl string `json:"referendumUrl,omitempty"`
	// Roles: The roles which this office fulfills.
	//
	// Possible values:
	//   "headOfState"
	//   "headOfGovernment"
	//   "deputyHeadOfGovernment"
	//   "governmentOfficer"
	//   "executiveCouncil"
	//   "legislatorUpperBody"
	//   "legislatorLowerBody"
	//   "highestCourtJudge"
	//   "judge"
	//   "schoolBoard"
	//   "specialPurposeOfficer"
	//   "otherRole"
	Roles []string `json:"roles,omitempty"`
	// Sources: A list of sources for this contest. If multiple sources are listed,
	// the data has been aggregated from those sources.
	Sources []*CivicinfoSchemaV2Source `json:"sources,omitempty"`
	// Special: "Yes" or "No" depending on whether this a contest being held
	// outside the normal election cycle.
	Special string `json:"special,omitempty"`
	// Type: The type of contest. Usually this will be 'General', 'Primary', or
	// 'Run-off' for contests with candidates. For referenda this will be
	// 'Referendum'. For Retention contests this will typically be 'Retention'.
	Type string `json:"type,omitempty"`
	// ForceSendFields is a list of field names (e.g. "BallotPlacement") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "BallotPlacement") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoSchemaV2Contest) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoSchemaV2Contest
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoSchemaV2Election: Information about the election that was queried.
type CivicinfoSchemaV2Election struct {
	// ElectionDay: Day of the election in YYYY-MM-DD format.
	ElectionDay string `json:"electionDay,omitempty"`
	// Id: The unique ID of this election.
	Id int64 `json:"id,omitempty,string"`
	// Name: A displayable name for the election.
	Name string `json:"name,omitempty"`
	// OcdDivisionId: The political division of the election. Represented as an OCD
	// Division ID. Voters within these political jurisdictions are covered by this
	// election. This is typically a state such as ocd-division/country:us/state:ca
	// or for the midterms or general election the entire US (i.e.
	// ocd-division/country:us).
	OcdDivisionId string `json:"ocdDivisionId,omitempty"`
	// Possible values:
	//   "shapeLookupDefault"
	//   "shapeLookupDisabled"
	//   "shapeLookupEnabled"
	ShapeLookupBehavior string `json:"shapeLookupBehavior,omitempty"`
	// ForceSendFields is a list of field names (e.g. "ElectionDay") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "ElectionDay") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoSchemaV2Election) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoSchemaV2Election
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoSchemaV2ElectionOfficial: Information about individual election
// officials.
type CivicinfoSchemaV2ElectionOfficial struct {
	// EmailAddress: The email address of the election official.
	EmailAddress string `json:"emailAddress,omitempty"`
	// FaxNumber: The fax number of the election official.
	FaxNumber string `json:"faxNumber,omitempty"`
	// Name: The full name of the election official.
	Name string `json:"name,omitempty"`
	// OfficePhoneNumber: The office phone number of the election official.
	OfficePhoneNumber string `json:"officePhoneNumber,omitempty"`
	// Title: The title of the election official.
	Title string `json:"title,omitempty"`
	// ForceSendFields is a list of field names (e.g. "EmailAddress") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "EmailAddress") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoSchemaV2ElectionOfficial) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoSchemaV2ElectionOfficial
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoSchemaV2ElectoralDistrict: Describes the geographic scope of a
// contest.
type CivicinfoSchemaV2ElectoralDistrict struct {
	// Id: An identifier for this district, relative to its scope. For example, the
	// 34th State Senate district would have id "34" and a scope of stateUpper.
	Id string `json:"id,omitempty"`
	// Name: The name of the district.
	Name string `json:"name,omitempty"`
	// Scope: The geographic scope of this district. If unspecified the district's
	// geography is not known. One of: national, statewide, congressional,
	// stateUpper, stateLower, countywide, judicial, schoolBoard, cityWide,
	// township, countyCouncil, cityCouncil, ward, special
	//
	// Possible values:
	//   "statewide"
	//   "congressional"
	//   "stateUpper"
	//   "stateLower"
	//   "countywide"
	//   "judicial"
	//   "schoolBoard"
	//   "citywide"
	//   "special"
	//   "countyCouncil"
	//   "township"
	//   "ward"
	//   "cityCouncil"
	//   "national"
	Scope string `json:"scope,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Id") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Id") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoSchemaV2ElectoralDistrict) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoSchemaV2ElectoralDistrict
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoSchemaV2GeographicDivision: Describes a political geography.
type CivicinfoSchemaV2GeographicDivision struct {
	// AlsoKnownAs: Any other valid OCD IDs that refer to the same
	// division.\n\nBecause OCD IDs are meant to be human-readable and at least
	// somewhat predictable, there are occasionally several identifiers for a
	// single division. These identifiers are defined to be equivalent to one
	// another, and one is always indicated as the primary identifier. The primary
	// identifier will be returned in ocd_id above, and any other equivalent valid
	// identifiers will be returned in this list.\n\nFor example, if this
	// division's OCD ID is ocd-division/country:us/district:dc, this will contain
	// ocd-division/country:us/state:dc.
	AlsoKnownAs []string `json:"alsoKnownAs,omitempty"`
	// Name: The name of the division.
	Name string `json:"name,omitempty"`
	// OfficeIndices: List of indices in the offices array, one for each office
	// elected from this division. Will only be present if includeOffices was true
	// (or absent) in the request.
	OfficeIndices []int64 `json:"officeIndices,omitempty"`
	// ForceSendFields is a list of field names (e.g. "AlsoKnownAs") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AlsoKnownAs") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoSchemaV2GeographicDivision) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoSchemaV2GeographicDivision
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoSchemaV2PollingLocation: A location where a voter can vote. This
// may be an early vote site, an election day voting location, or a drop off
// location for a completed ballot.
type CivicinfoSchemaV2PollingLocation struct {
	// Address: The address of the location.
	Address *CivicinfoSchemaV2SimpleAddressType `json:"address,omitempty"`
	// EndDate: The last date that this early vote site or drop off location may be
	// used. This field is not populated for polling locations.
	EndDate string `json:"endDate,omitempty"`
	// Latitude: Latitude of the location, in degrees north of the equator. Note
	// this field may not be available for some locations.
	Latitude float64 `json:"latitude,omitempty"`
	// Longitude: Longitude of the location, in degrees east of the Prime Meridian.
	// Note this field may not be available for some locations.
	Longitude float64 `json:"longitude,omitempty"`
	// Name: The name of the early vote site or drop off location. This field is
	// not populated for polling locations.
	Name string `json:"name,omitempty"`
	// Notes: Notes about this location (e.g. accessibility ramp or entrance to
	// use).
	Notes string `json:"notes,omitempty"`
	// PollingHours: A description of when this location is open.
	PollingHours string `json:"pollingHours,omitempty"`
	// Sources: A list of sources for this location. If multiple sources are listed
	// the data has been aggregated from those sources.
	Sources []*CivicinfoSchemaV2Source `json:"sources,omitempty"`
	// StartDate: The first date that this early vote site or drop off location may
	// be used. This field is not populated for polling locations.
	StartDate string `json:"startDate,omitempty"`
	// VoterServices: The services provided by this early vote site or drop off
	// location. This field is not populated for polling locations.
	VoterServices string `json:"voterServices,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Address") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Address") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoSchemaV2PollingLocation) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoSchemaV2PollingLocation
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

func (s *CivicinfoSchemaV2PollingLocation) UnmarshalJSON(data []byte) error {
	type NoMethod CivicinfoSchemaV2PollingLocation
	var s1 struct {
		Latitude  gensupport.JSONFloat64 `json:"latitude"`
		Longitude gensupport.JSONFloat64 `json:"longitude"`
		*NoMethod
	}
	s1.NoMethod = (*NoMethod)(s)
	if err := json.Unmarshal(data, &s1); err != nil {
		return err
	}
	s.Latitude = float64(s1.Latitude)
	s.Longitude = float64(s1.Longitude)
	return nil
}

type CivicinfoSchemaV2Precinct struct {
	// AdministrationRegionId: ID of the AdministrationRegion message for this
	// precinct. Corresponds to LocalityId xml tag.
	AdministrationRegionId string `json:"administrationRegionId,omitempty"`
	// ContestId: ID(s) of the Contest message(s) for this precinct.
	ContestId []string `json:"contestId,omitempty"`
	// DatasetId: Required. Dataset ID. What datasets our Precincts come from.
	DatasetId int64 `json:"datasetId,omitempty,string"`
	// EarlyVoteSiteId: ID(s) of the PollingLocation message(s) for this precinct.
	EarlyVoteSiteId []string `json:"earlyVoteSiteId,omitempty"`
	// ElectoralDistrictId: ID(s) of the ElectoralDistrict message(s) for this
	// precinct.
	ElectoralDistrictId []string `json:"electoralDistrictId,omitempty"`
	// Id: Required. A unique identifier for this precinct.
	Id string `json:"id,omitempty"`
	// MailOnly: Specifies if the precinct runs mail-only elections.
	MailOnly bool `json:"mailOnly,omitempty"`
	// Name: Required. The name of the precinct.
	Name string `json:"name,omitempty"`
	// Number: The number of the precinct.
	Number string `json:"number,omitempty"`
	// OcdId: Encouraged. The OCD ID of the precinct
	OcdId []string `json:"ocdId,omitempty"`
	// PollingLocationId: ID(s) of the PollingLocation message(s) for this
	// precinct.
	PollingLocationId []string `json:"pollingLocationId,omitempty"`
	// SpatialBoundaryId: ID(s) of the SpatialBoundary message(s) for this
	// precinct. Used to specify a geometrical boundary of the precinct.
	SpatialBoundaryId []string `json:"spatialBoundaryId,omitempty"`
	// SplitName: If present, this proto corresponds to one portion of split
	// precinct. Other portions of this precinct are guaranteed to have the same
	// `name`. If not present, this proto represents a full precicnt.
	SplitName string `json:"splitName,omitempty"`
	// Ward: Specifies the ward the precinct is contained within.
	Ward string `json:"ward,omitempty"`
	// ForceSendFields is a list of field names (e.g. "AdministrationRegionId") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AdministrationRegionId") to
	// include in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoSchemaV2Precinct) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoSchemaV2Precinct
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoSchemaV2SimpleAddressType: A simple representation of an address.
type CivicinfoSchemaV2SimpleAddressType struct {
	AddressLine []string `json:"addressLine,omitempty"`
	// City: The city or town for the address.
	City string `json:"city,omitempty"`
	// Line1: The street name and number of this address.
	Line1 string `json:"line1,omitempty"`
	// Line2: The second line the address, if needed.
	Line2 string `json:"line2,omitempty"`
	// Line3: The third line of the address, if needed.
	Line3 string `json:"line3,omitempty"`
	// LocationName: The name of the location.
	LocationName string `json:"locationName,omitempty"`
	// State: The US two letter state abbreviation of the address.
	State string `json:"state,omitempty"`
	// Zip: The US Postal Zip Code of the address.
	Zip string `json:"zip,omitempty"`
	// ForceSendFields is a list of field names (e.g. "AddressLine") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AddressLine") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoSchemaV2SimpleAddressType) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoSchemaV2SimpleAddressType
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

// CivicinfoSchemaV2Source: Contains information about the data source for the
// element containing it.
type CivicinfoSchemaV2Source struct {
	// Name: The name of the data source.
	Name string `json:"name,omitempty"`
	// Official: Whether this data comes from an official government source.
	Official bool `json:"official,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Name") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Name") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (s CivicinfoSchemaV2Source) MarshalJSON() ([]byte, error) {
	type NoMethod CivicinfoSchemaV2Source
	return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields)
}

type DivisionsQueryDivisionByAddressCall struct {
	s            *Service
	urlParams_   gensupport.URLParams
	ifNoneMatch_ string
	ctx_         context.Context
	header_      http.Header
}

// QueryDivisionByAddress: Lookup OCDIDs and names for divisions related to an
// address.
func (r *DivisionsService) QueryDivisionByAddress() *DivisionsQueryDivisionByAddressCall {
	c := &DivisionsQueryDivisionByAddressCall{s: r.s, urlParams_: make(gensupport.URLParams)}
	return c
}

// Address sets the optional parameter "address":
func (c *DivisionsQueryDivisionByAddressCall) Address(address string) *DivisionsQueryDivisionByAddressCall {
	c.urlParams_.Set("address", address)
	return c
}

// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more
// details.
func (c *DivisionsQueryDivisionByAddressCall) Fields(s ...googleapi.Field) *DivisionsQueryDivisionByAddressCall {
	c.urlParams_.Set("fields", googleapi.CombineFields(s))
	return c
}

// IfNoneMatch sets an optional parameter which makes the operation fail if the
// object's ETag matches the given value. This is useful for getting updates
// only after the object has changed since the last request.
func (c *DivisionsQueryDivisionByAddressCall) IfNoneMatch(entityTag string) *DivisionsQueryDivisionByAddressCall {
	c.ifNoneMatch_ = entityTag
	return c
}

// Context sets the context to be used in this call's Do method.
func (c *DivisionsQueryDivisionByAddressCall) Context(ctx context.Context) *DivisionsQueryDivisionByAddressCall {
	c.ctx_ = ctx
	return c
}

// Header returns a http.Header that can be modified by the caller to add
// headers to the request.
func (c *DivisionsQueryDivisionByAddressCall) Header() http.Header {
	if c.header_ == nil {
		c.header_ = make(http.Header)
	}
	return c.header_
}

func (c *DivisionsQueryDivisionByAddressCall) doRequest(alt string) (*http.Response, error) {
	reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_)
	if c.ifNoneMatch_ != "" {
		reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
	}
	c.urlParams_.Set("alt", alt)
	c.urlParams_.Set("prettyPrint", "false")
	urls := googleapi.ResolveRelative(c.s.BasePath, "civicinfo/v2/divisionsByAddress")
	urls += "?" + c.urlParams_.Encode()
	req, err := http.NewRequest("GET", urls, nil)
	if err != nil {
		return nil, err
	}
	req.Header = reqHeaders
	c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "civicinfo.divisions.queryDivisionByAddress", "request", internallog.HTTPRequest(req, nil))
	return gensupport.SendRequest(c.ctx_, c.s.client, req)
}

// Do executes the "civicinfo.divisions.queryDivisionByAddress" call.
// Any non-2xx status code is an error. Response headers are in either
// *CivicinfoApiprotosV2DivisionByAddressResponse.ServerResponse.Header or (if
// a response was returned at all) in error.(*googleapi.Error).Header. Use
// googleapi.IsNotModified to check whether the returned error was because
// http.StatusNotModified was returned.
func (c *DivisionsQueryDivisionByAddressCall) Do(opts ...googleapi.CallOption) (*CivicinfoApiprotosV2DivisionByAddressResponse, error) {
	gensupport.SetOptions(c.urlParams_, opts...)
	res, err := c.doRequest("json")
	if res != nil && res.StatusCode == http.StatusNotModified {
		if res.Body != nil {
			res.Body.Close()
		}
		return nil, gensupport.WrapError(&googleapi.Error{
			Code:   res.StatusCode,
			Header: res.Header,
		})
	}
	if err != nil {
		return nil, err
	}
	defer googleapi.CloseBody(res)
	if err := googleapi.CheckResponse(res); err != nil {
		return nil, gensupport.WrapError(err)
	}
	ret := &CivicinfoApiprotosV2DivisionByAddressResponse{
		ServerResponse: googleapi.ServerResponse{
			Header:         res.Header,
			HTTPStatusCode: res.StatusCode,
		},
	}
	target := &ret
	b, err := gensupport.DecodeResponseBytes(target, res)
	if err != nil {
		return nil, err
	}
	c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "civicinfo.divisions.queryDivisionByAddress", "response", internallog.HTTPResponse(res, b))
	return ret, nil
}

type DivisionsSearchCall struct {
	s            *Service
	urlParams_   gensupport.URLParams
	ifNoneMatch_ string
	ctx_         context.Context
	header_      http.Header
}

// Search: Searches for political divisions by their natural name or OCD ID.
func (r *DivisionsService) Search() *DivisionsSearchCall {
	c := &DivisionsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
	return c
}

// Query sets the optional parameter "query": The search query. Queries can
// cover any parts of a OCD ID or a human readable division name. All words
// given in the query are treated as required patterns. In addition to that,
// most query operators of the Apache Lucene library are supported. See
// http://lucene.apache.org/core/2_9_4/queryparsersyntax.html
func (c *DivisionsSearchCall) Query(query string) *DivisionsSearchCall {
	c.urlParams_.Set("query", query)
	return c
}

// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more
// details.
func (c *DivisionsSearchCall) Fields(s ...googleapi.Field) *DivisionsSearchCall {
	c.urlParams_.Set("fields", googleapi.CombineFields(s))
	return c
}

// IfNoneMatch sets an optional parameter which makes the operation fail if the
// object's ETag matches the given value. This is useful for getting updates
// only after the object has changed since the last request.
func (c *DivisionsSearchCall) IfNoneMatch(entityTag string) *DivisionsSearchCall {
	c.ifNoneMatch_ = entityTag
	return c
}

// Context sets the context to be used in this call's Do method.
func (c *DivisionsSearchCall) Context(ctx context.Context) *DivisionsSearchCall {
	c.ctx_ = ctx
	return c
}

// Header returns a http.Header that can be modified by the caller to add
// headers to the request.
func (c *DivisionsSearchCall) Header() http.Header {
	if c.header_ == nil {
		c.header_ = make(http.Header)
	}
	return c.header_
}

func (c *DivisionsSearchCall) doRequest(alt string) (*http.Response, error) {
	reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_)
	if c.ifNoneMatch_ != "" {
		reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
	}
	c.urlParams_.Set("alt", alt)
	c.urlParams_.Set("prettyPrint", "false")
	urls := googleapi.ResolveRelative(c.s.BasePath, "civicinfo/v2/divisions")
	urls += "?" + c.urlParams_.Encode()
	req, err := http.NewRequest("GET", urls, nil)
	if err != nil {
		return nil, err
	}
	req.Header = reqHeaders
	c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "civicinfo.divisions.search", "request", internallog.HTTPRequest(req, nil))
	return gensupport.SendRequest(c.ctx_, c.s.client, req)
}

// Do executes the "civicinfo.divisions.search" call.
// Any non-2xx status code is an error. Response headers are in either
// *CivicinfoApiprotosV2DivisionSearchResponse.ServerResponse.Header or (if a
// response was returned at all) in error.(*googleapi.Error).Header. Use
// googleapi.IsNotModified to check whether the returned error was because
// http.StatusNotModified was returned.
func (c *DivisionsSearchCall) Do(opts ...googleapi.CallOption) (*CivicinfoApiprotosV2DivisionSearchResponse, error) {
	gensupport.SetOptions(c.urlParams_, opts...)
	res, err := c.doRequest("json")
	if res != nil && res.StatusCode == http.StatusNotModified {
		if res.Body != nil {
			res.Body.Close()
		}
		return nil, gensupport.WrapError(&googleapi.Error{
			Code:   res.StatusCode,
			Header: res.Header,
		})
	}
	if err != nil {
		return nil, err
	}
	defer googleapi.CloseBody(res)
	if err := googleapi.CheckResponse(res); err != nil {
		return nil, gensupport.WrapError(err)
	}
	ret := &CivicinfoApiprotosV2DivisionSearchResponse{
		ServerResponse: googleapi.ServerResponse{
			Header:         res.Header,
			HTTPStatusCode: res.StatusCode,
		},
	}
	target := &ret
	b, err := gensupport.DecodeResponseBytes(target, res)
	if err != nil {
		return nil, err
	}
	c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "civicinfo.divisions.search", "response", internallog.HTTPResponse(res, b))
	return ret, nil
}

type ElectionsElectionQueryCall struct {
	s            *Service
	urlParams_   gensupport.URLParams
	ifNoneMatch_ string
	ctx_         context.Context
	header_      http.Header
}

// ElectionQuery: List of available elections to query.
func (r *ElectionsService) ElectionQuery() *ElectionsElectionQueryCall {
	c := &ElectionsElectionQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)}
	return c
}

// ProductionDataOnly sets the optional parameter "productionDataOnly": Whether
// to include data that has not been allowlisted yet
func (c *ElectionsElectionQueryCall) ProductionDataOnly(productionDataOnly bool) *ElectionsElectionQueryCall {
	c.urlParams_.Set("productionDataOnly", fmt.Sprint(productionDataOnly))
	return c
}

// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more
// details.
func (c *ElectionsElectionQueryCall) Fields(s ...googleapi.Field) *ElectionsElectionQueryCall {
	c.urlParams_.Set("fields", googleapi.CombineFields(s))
	return c
}

// IfNoneMatch sets an optional parameter which makes the operation fail if the
// object's ETag matches the given value. This is useful for getting updates
// only after the object has changed since the last request.
func (c *ElectionsElectionQueryCall) IfNoneMatch(entityTag string) *ElectionsElectionQueryCall {
	c.ifNoneMatch_ = entityTag
	return c
}

// Context sets the context to be used in this call's Do method.
func (c *ElectionsElectionQueryCall) Context(ctx context.Context) *ElectionsElectionQueryCall {
	c.ctx_ = ctx
	return c
}

// Header returns a http.Header that can be modified by the caller to add
// headers to the request.
func (c *ElectionsElectionQueryCall) Header() http.Header {
	if c.header_ == nil {
		c.header_ = make(http.Header)
	}
	return c.header_
}

func (c *ElectionsElectionQueryCall) doRequest(alt string) (*http.Response, error) {
	reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_)
	if c.ifNoneMatch_ != "" {
		reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
	}
	c.urlParams_.Set("alt", alt)
	c.urlParams_.Set("prettyPrint", "false")
	urls := googleapi.ResolveRelative(c.s.BasePath, "civicinfo/v2/elections")
	urls += "?" + c.urlParams_.Encode()
	req, err := http.NewRequest("GET", urls, nil)
	if err != nil {
		return nil, err
	}
	req.Header = reqHeaders
	c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "civicinfo.elections.electionQuery", "request", internallog.HTTPRequest(req, nil))
	return gensupport.SendRequest(c.ctx_, c.s.client, req)
}

// Do executes the "civicinfo.elections.electionQuery" call.
// Any non-2xx status code is an error. Response headers are in either
// *CivicinfoApiprotosV2ElectionsQueryResponse.ServerResponse.Header or (if a
// response was returned at all) in error.(*googleapi.Error).Header. Use
// googleapi.IsNotModified to check whether the returned error was because
// http.StatusNotModified was returned.
func (c *ElectionsElectionQueryCall) Do(opts ...googleapi.CallOption) (*CivicinfoApiprotosV2ElectionsQueryResponse, error) {
	gensupport.SetOptions(c.urlParams_, opts...)
	res, err := c.doRequest("json")
	if res != nil && res.StatusCode == http.StatusNotModified {
		if res.Body != nil {
			res.Body.Close()
		}
		return nil, gensupport.WrapError(&googleapi.Error{
			Code:   res.StatusCode,
			Header: res.Header,
		})
	}
	if err != nil {
		return nil, err
	}
	defer googleapi.CloseBody(res)
	if err := googleapi.CheckResponse(res); err != nil {
		return nil, gensupport.WrapError(err)
	}
	ret := &CivicinfoApiprotosV2ElectionsQueryResponse{
		ServerResponse: googleapi.ServerResponse{
			Header:         res.Header,
			HTTPStatusCode: res.StatusCode,
		},
	}
	target := &ret
	b, err := gensupport.DecodeResponseBytes(target, res)
	if err != nil {
		return nil, err
	}
	c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "civicinfo.elections.electionQuery", "response", internallog.HTTPResponse(res, b))
	return ret, nil
}

type ElectionsVoterInfoQueryCall struct {
	s            *Service
	urlParams_   gensupport.URLParams
	ifNoneMatch_ string
	ctx_         context.Context
	header_      http.Header
}

// VoterInfoQuery: Looks up information relevant to a voter based on the
// voter's registered address.
func (r *ElectionsService) VoterInfoQuery() *ElectionsVoterInfoQueryCall {
	c := &ElectionsVoterInfoQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)}
	return c
}

// Address sets the optional parameter "address": The registered address of the
// voter to look up.
func (c *ElectionsVoterInfoQueryCall) Address(address string) *ElectionsVoterInfoQueryCall {
	c.urlParams_.Set("address", address)
	return c
}

// ElectionId sets the optional parameter "electionId": The unique ID of the
// election to look up. A list of election IDs can be obtained at
// https://www.googleapis.com/civicinfo/{version}/elections. If no election ID
// is specified in the query and there is more than one election with data for
// the given voter, the additional elections are provided in the otherElections
// response field.
func (c *ElectionsVoterInfoQueryCall) ElectionId(electionId int64) *ElectionsVoterInfoQueryCall {
	c.urlParams_.Set("electionId", fmt.Sprint(electionId))
	return c
}

// OfficialOnly sets the optional parameter "officialOnly": If set to true,
// only data from official state sources will be returned.
func (c *ElectionsVoterInfoQueryCall) OfficialOnly(officialOnly bool) *ElectionsVoterInfoQueryCall {
	c.urlParams_.Set("officialOnly", fmt.Sprint(officialOnly))
	return c
}

// ProductionDataOnly sets the optional parameter "productionDataOnly": Whether
// to include data that has not been vetted yet. Should only be made available
// to internal IPs or trusted partners. This is a non-discoverable parameter in
// the One Platform API config.
func (c *ElectionsVoterInfoQueryCall) ProductionDataOnly(productionDataOnly bool) *ElectionsVoterInfoQueryCall {
	c.urlParams_.Set("productionDataOnly", fmt.Sprint(productionDataOnly))
	return c
}

// ReturnAllAvailableData sets the optional parameter "returnAllAvailableData":
// If set to true, the query will return the success code and include any
// partial information when it is unable to determine a matching address or
// unable to determine the election for electionId=0 queries.
func (c *ElectionsVoterInfoQueryCall) ReturnAllAvailableData(returnAllAvailableData bool) *ElectionsVoterInfoQueryCall {
	c.urlParams_.Set("returnAllAvailableData", fmt.Sprint(returnAllAvailableData))
	return c
}

// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more
// details.
func (c *ElectionsVoterInfoQueryCall) Fields(s ...googleapi.Field) *ElectionsVoterInfoQueryCall {
	c.urlParams_.Set("fields", googleapi.CombineFields(s))
	return c
}

// IfNoneMatch sets an optional parameter which makes the operation fail if the
// object's ETag matches the given value. This is useful for getting updates
// only after the object has changed since the last request.
func (c *ElectionsVoterInfoQueryCall) IfNoneMatch(entityTag string) *ElectionsVoterInfoQueryCall {
	c.ifNoneMatch_ = entityTag
	return c
}

// Context sets the context to be used in this call's Do method.
func (c *ElectionsVoterInfoQueryCall) Context(ctx context.Context) *ElectionsVoterInfoQueryCall {
	c.ctx_ = ctx
	return c
}

// Header returns a http.Header that can be modified by the caller to add
// headers to the request.
func (c *ElectionsVoterInfoQueryCall) Header() http.Header {
	if c.header_ == nil {
		c.header_ = make(http.Header)
	}
	return c.header_
}

func (c *ElectionsVoterInfoQueryCall) doRequest(alt string) (*http.Response, error) {
	reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_)
	if c.ifNoneMatch_ != "" {
		reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
	}
	c.urlParams_.Set("alt", alt)
	c.urlParams_.Set("prettyPrint", "false")
	urls := googleapi.ResolveRelative(c.s.BasePath, "civicinfo/v2/voterinfo")
	urls += "?" + c.urlParams_.Encode()
	req, err := http.NewRequest("GET", urls, nil)
	if err != nil {
		return nil, err
	}
	req.Header = reqHeaders
	c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "civicinfo.elections.voterInfoQuery", "request", internallog.HTTPRequest(req, nil))
	return gensupport.SendRequest(c.ctx_, c.s.client, req)
}

// Do executes the "civicinfo.elections.voterInfoQuery" call.
// Any non-2xx status code is an error. Response headers are in either
// *CivicinfoApiprotosV2VoterInfoResponse.ServerResponse.Header or (if a
// response was returned at all) in error.(*googleapi.Error).Header. Use
// googleapi.IsNotModified to check whether the returned error was because
// http.StatusNotModified was returned.
func (c *ElectionsVoterInfoQueryCall) Do(opts ...googleapi.CallOption) (*CivicinfoApiprotosV2VoterInfoResponse, error) {
	gensupport.SetOptions(c.urlParams_, opts...)
	res, err := c.doRequest("json")
	if res != nil && res.StatusCode == http.StatusNotModified {
		if res.Body != nil {
			res.Body.Close()
		}
		return nil, gensupport.WrapError(&googleapi.Error{
			Code:   res.StatusCode,
			Header: res.Header,
		})
	}
	if err != nil {
		return nil, err
	}
	defer googleapi.CloseBody(res)
	if err := googleapi.CheckResponse(res); err != nil {
		return nil, gensupport.WrapError(err)
	}
	ret := &CivicinfoApiprotosV2VoterInfoResponse{
		ServerResponse: googleapi.ServerResponse{
			Header:         res.Header,
			HTTPStatusCode: res.StatusCode,
		},
	}
	target := &ret
	b, err := gensupport.DecodeResponseBytes(target, res)
	if err != nil {
		return nil, err
	}
	c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "civicinfo.elections.voterInfoQuery", "response", internallog.HTTPResponse(res, b))
	return ret, nil
}
