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 | Observações |
---|---|---|---|
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 | Observações |
---|---|---|---|
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:
|
|
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:
|
|
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 | Observações |
---|---|---|---|
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.