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 nessa 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 de API específica feita. A seção offices lista as posições políticas eleitas para representar as divisões na primeira seção. A seção officials lista as pessoas que atendem 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 exclusivo de dados cívicos abertos da divisão.
`divisions.(key).alsoKnownAs[]`	`list`	Quaisquer outros IDs de OCD válidos que se referem à mesma divisão. Como os IDs de TOC precisam ser legíveis e um pouco previsíveis, às vezes há vários identificadores para uma única divisão. Esses identificadores são definidos como equivalentes um ao outro, e um é sempre indicado como o identificador principal. O identificador principal 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 dessa divisão for ocd-division/country:us/district:dc, ele vai conter 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 escritório eleito nesta 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 referenciados pelas divisões listadas acima. Só vai estar presente se includeOffices for verdadeira na solicitação.
`offices[].divisionId`	`string`	O ID de OCD da divisão a que esse escritório está associado.
`offices[].levels[]`	`list`	Os níveis de governo de que este escritório faz parte. Pode haver mais de um nos casos em que uma jurisdição atua efetivamente em dois níveis diferentes de governo. Por exemplo, o prefeito do Distrito de Colúmbia atua no nível da "localidade", mas também de maneira efetiva em `administrativeArea2` e `administrativeArea1`. Os valores válidos incluem: `international`: governos internacionais, como as Nações Unidas ou a União Europeia. `country` : governos de nível nacional, como o governo federal dos EUA. `administrativeArea1`: governos da subdivisão administrativa de nível superior de um país, como estados dos EUA. `regional`: governos regionais com jurisdição que possa ultrapassar as subdivisões administrativas padrão. Essas subdivisões 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`: governos municipais ou 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 Bairro consultivo 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 no grupo de oficiais de pessoas que atualmente ocupam esse cargo.
`offices[].roles[]`	`list`	As funções que esse escritório cumpre. As funções não pretendem ser uma lista completa ou especificar exatamente todo o conjunto de responsabilidades de um determinado escritório, mas devem ser categorias gerais úteis para a seleção geral ou classificação de uma lista de escritórios. Os valores válidos incluem: `headOfState` : o representante público principal de um governo. Geralmente, o chefe de Estado de um país é chamado de presidente. `headOfGovernment`: o diretor executivo de um governo. Nos EUA, é o presidente; em outros países, é frequentemente 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. Este escritório também pode ter outras tarefas. `governmentOfficer`: um funcionário administrativo eleito. Nos estados dos EUA, isso inclui funções como advogado-geral, administrador, secretário, estado ou tesoureiro. `executiveCouncil`: um membro de um conselho executivo que ocupa cargos executivos como um grupo. Exemplos incluem comissários do condado de Indiana. `legislatorUpperBody`: um membro do corpo legislativo bicameral ou o único corpo de uma legislatura unicameral. `legislatorLowerBody`: membro do corpo legislativo bicameral. `highestCourtJudge`: um juiz do tribunal superior de um governo específico, como uma Suprema Corte estadual. `judge`: um juiz de qualquer tribunal que não seja o tribunal superior do governo no qual atua. `schoolBoard`: membro de um conselho escolar local. `specialPurposeOfficer`: um agente que tem um único propósito definido, como ser membro de um conselho de conservação de solo e água ou um oficial de combate a mosquitos.
`offices[].sources[]`	`list`	Uma lista de fontes para este escritório. Se várias origens estiverem listadas, os dados foram agregados a partir delas.
`offices[].sources[].name`	`string`	O nome da fonte de dados.
`offices[].sources[].official`	`boolean`	Indica se esses dados vêm de uma fonte governamental oficial.

Representantes eleitos

Nome da propriedade	Valor	Descrição
`officials[]`	`list`	Funcionários que ocupam os escritórios listados acima Só vai estar presente se includeOffices for verdadeira 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 do 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 duas letras do endereço nos EUA.
`officials[].address[].zip`	`string`	O CEP do endereço nos EUA.
`officials[].channels[]`	`list`	Uma lista dos canais de mídia social 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. Veja a seguir uma lista dos tipos de canais, mas esta não é uma lista completa. Outros tipos de canais poderão ser adicionados depois. 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 oficial.
`officials[].party`	`string`	O nome completo do partido a que o funcionário pertence.
`officials[].phones[]`	`list`	Os números de telefone de contato público do funcionário.
`officials[].photoUrl`	`string`	Um URL para uma foto do oficial.
`officials[].urls[]`	`list`	Os URLs dos sites públicos do oficial.

Métodos

representativeInfoByAddress: Procura informações geográficas e representativas de um único endereço.
representativeInfoByDivision: Procura informações representativas de uma única divisão geográfica.