Esta página foi traduzida pela API Cloud Translation.

Representatives

Essa coleção inclui informações sobre geografia política e funcionários eleitos.

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

Um recurso desta coleção tem três seções, descritas em detalhes abaixo. A seção divisions lista divisões geográficas políticas, como um país, estado, condado ou distrito legislativo. As divisões que serão listadas dependem da solicitação específica da API feita. A seção offices lista os cargos políticos que são eleitos para representar as divisões na primeira seção. A seção officials lista pessoas que atuam nos escritórios listados.

{
  "divisions": {
    (key): {
      "name": string,
      "alsoKnownAs": [
        string
      ],
      "officeIndices": [
        unsigned integer
      ]
    }
  },
  "offices": [
    {
      "name": string,
      "divisionId": string,
      "levels": [
        string
      ],
      "roles": [
        string
      ],
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ],
      "officialIndices": [
        unsigned integer
      ]
    }
  ],
  "officials": [
    {
      "name": string,
      "address": [
        {
          "locationName": string,
          "line1": string,
          "line2": string,
          "line3": string,
          "city": string,
          "state": string,
          "zip": string
        }
      ],
      "party": string,
      "phones": [
        string
      ],
      "urls": [
        string
      ],
      "photoUrl": string,
      "emails": [
        string
      ],
      "channels": [
        {
          "type": string,
          "id": string
        }
      ]
    }
  ]
}

Geografia política

Nome da propriedade	Valor	Descrição
`divisions`	`object`	Divisões geográficas políticas que contêm o endereço solicitado.
`divisions.(key)`	`nested object`	O identificador de dados cívicos abertos exclusivo da divisão.
`divisions.(key).alsoKnownAs[]`	`list`	Outros IDs de OCD válidos que se referem à mesma divisão. Como os IDs de OCD são legíveis e, pelo menos, previsíveis, às vezes, há vários identificadores para uma única divisão. Esses identificadores são definidos como equivalentes entre si, e um é sempre indicado como o identificador principal. O identificador primário será retornado no ocd_id acima, e quaisquer outros identificadores válidos equivalentes serão retornados nesta lista. Por exemplo, se o ID de OCD da divisão for ocd-division/country:us/distrito:dc, ele vai incluir ocd-division/country:us/state:dc.
`divisions.(key).name`	`string`	É o nome da divisão.
`divisions.(key).officeIndices[]`	`list`	Lista de índices na matriz `offices`, um para cada cargo eletivo da divisão. Só vai estar presente se `includeOffices` for verdadeiro (ou ausente) na solicitação.

Cargos eleitos

Nome da propriedade	Valor	Descrição
`offices[]`	`list`	Cargos eleitos mencionados pelas divisões listadas acima. Só vai estar presente se includeOffices for verdadeiro na solicitação.
`offices[].divisionId`	`string`	O ID do OCD da divisão a que este escritório está associado.
`offices[].levels[]`	`list`	Os níveis de governo do qual esse escritório faz parte. Pode haver mais de um nos casos em que uma jurisdição atue efetivamente em dois níveis de governo diferentes; por exemplo, o prefeito do Distrito de Colúmbia atua na "região administrativa" mas também de forma eficiente tanto no `administrativeArea2` quanto no `administrativeArea1`. Os valores válidos incluem: `international`: governos internacionais, como as Nações Unidas ou a União Europeia. `country` : governos em nível nacional, como o governo federal dos EUA. `administrativeArea1`: governos da subdivisão administrativa de nível superior de um país, como os estados dos EUA. `regional` -- Governos regionais cuja jurisdição possa cruzar as subdivisões administrativas padrão são incomuns nos EUA, mas são comuns em grandes cidades de outros países. `administrativeArea2`: governos da subdivisão administrativa de segundo nível de um país, como condados dos EUA. `locality` -- Prefeituras ou governos municipais. `subLocality1`: governos da subdivisão administrativa de nível superior de uma cidade, como os distritos de Washington, DC. `subLocality2`: governos da subdivisão administrativa de segundo nível de uma cidade,como os Conselhos de Vizinhança de Washington, DC. `special`: distritos locais que existem apenas para governos com fins especiais, como distritos de conservação de solo e água.
`offices[].name`	`string`	O nome legível do escritório.
`offices[].officialIndices[]`	`list`	Lista de índices da matriz de funcionários que ocupam este cargo no momento.
`offices[].roles[]`	`list`	As funções que este escritório cumpre. As funções não são exaustivas ou especificam exatamente todo o conjunto de responsabilidades de um determinado escritório. Elas são categorias aproximadas úteis para a seleção ou classificação de uma lista de escritórios. Valores válidos incluem: `headOfState` -- O representante público principal de um governo. O chefe de Estado de um país geralmente é chamado de presidente. `headOfGovernment`: o diretor executivo de um governo. Nos EUA, é o presidente, em outros países, geralmente é o primeiro-ministro. Em níveis mais baixos, pode ser um governador ou prefeito. `deputyHeadOfGovernment`: o oficial responsável por assumir o cargo de chefe de governo no caso de morte ou incapacidade do chefe de governo eleito. Nos EUA, ele é o vice-presidente. Esse escritório também pode ter outras tarefas. `governmentOfficer` -- Um diretor executivo eleito. Nos estados dos EUA, isso pode incluir cargos como procurador-geral, controlador, secretário ou estado ou tesoureiro. `executiveCouncil`: membro de um conselho executivo que desempenha funções no ramo executivo como um grupo. Os exemplos incluem comissários do condado de Indiana. `legislatorUpperBody`: membro da parte superior de um legislativo bicameral ou o único órgão de um legislativo unicameral. `legislatorLowerBody`: membro do corpo inferior de um legislativo bicameral. `highestCourtJudge`: um juiz de um tribunal superior de um determinado governo, como uma Suprema Corte estadual. `judge`: um juiz de qualquer tribunal que não seja o principal tribunal do governo que ele atende. `schoolBoard`: membro de uma escola local. `specialPurposeOfficer`: um oficial que atende a um único propósito definido, como ser membro de um conselho de conservação de solo e água ou de combate a mosquitos.
`offices[].sources[]`	`list`	Uma lista de fontes desse escritório. Se várias fontes estiverem listadas, os dados delas foram agregados.
`offices[].sources[].name`	`string`	Nome da fonte de dados.
`offices[].sources[].official`	`boolean`	Se esses dados vêm de uma fonte governamental oficial.

Autoridades eleitas

Nome da propriedade	Valor	Descrição
`officials[]`	`list`	Autoridades que ocupam os cargos listados acima. Só vai estar presente se includeOffices for verdadeiro na solicitação.
`officials[].address[]`	`list`	Endereços para entrar em contato com o funcionário.
`officials[].address[].city`	`string`	A cidade do endereço.
`officials[].address[].line1`	`string`	O nome da rua e o número desse endereço.
`officials[].address[].line2`	`string`	A segunda linha, o endereço, se necessário.
`officials[].address[].line3`	`string`	A terceira linha do endereço, se necessário.
`officials[].address[].locationName`	`string`	Nome do local.
`officials[].address[].state`	`string`	A abreviação de estado com duas letras dos EUA do endereço.
`officials[].address[].zip`	`string`	O CEP do endereço nos EUA.
`officials[].channels[]`	`list`	Uma lista de canais de mídias sociais conhecidos do funcionário.
`officials[].channels[].id`	`string`	O identificador público exclusivo do canal do candidato.
`officials[].channels[].type`	`string`	O tipo de canal. Confira a seguir uma lista de tipos de canais, mas esta não é uma lista completa. Outros tipos de canal podem ser adicionados no futuro. Uma destas opções: YouTube, Facebook ou Twitter
`officials[].emails[]`	`list`	Os endereços de e-mail diretos do funcionário.
`officials[].name`	`string`	O nome do funcionário.
`officials[].party`	`string`	O nome completo do partido a que o funcionário pertence.
`officials[].phones[]`	`list`	Os números de telefone públicos para contato do funcionário.
`officials[].photoUrl`	`string`	Um URL para uma foto do funcionário.
`officials[].urls[]`	`list`	Os URLs do site público do oficial.

Métodos

representativeInfoByAddress: Pesquisa a geografia política e informações representativas de um único endereço.
representativeInfoByDivision: Procura informações representativas de uma única divisão geográfica.