Esta colección incluye información sobre geografía política y funcionarios electos.
Si quieres ver una lista de los métodos para este recurso, consulta la sección final de esta página.
Representaciones de recursos
Un recurso de esta colección tiene tres secciones, que se describen en detalle a continuación. La sección divisions
enumera las divisiones geográficas políticas, como un país, un estado, un condado o un distrito legislativo. (Las divisiones que se enumerarán dependen de la solicitud específica a la API realizada). En la sección offices
, se enumeran las posiciones políticas que se eligen para representar las divisiones de la primera sección. La sección officials
enumera a las personas que actualmente prestan servicio en las oficinas enumeradas.
{ "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 } ] } ] }
Geografía política
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
divisions |
object |
Divisiones geográficas geográficas que contienen la dirección solicitada. | |
divisions.(key) |
nested object |
Es el identificador único de Open Civic Data de esta división. | |
divisions.(key).alsoKnownAs[] |
list |
Cualquier otro ID de TOC válido que se refiera a la misma división Dado que los IDs de TOC deben ser legibles y, al menos, predecibles, a veces existen varios identificadores para una sola división. Estos identificadores se definen como equivalentes entre sí y siempre se indica uno como el identificador principal. El identificador principal aparecerá en ocd_id arriba y cualquier otro identificador válido equivalente se mostrará en esta lista. Por ejemplo, si el ID de TOC de esta división es ocd-division/country:us/district:dc, contendrá ocd-division/country:us/state:dc. |
|
divisions.(key).name |
string |
El nombre de la división. | |
divisions.(key).officeIndices[] |
list |
Lista de índices del array offices , uno por cada cargo elegido de esta división. Solo estará presente si includeOffices era verdadero (o no) en la solicitud. |
Oficinas elegidas
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
offices[] |
list |
Oficinas elegidas a las que se hace referencia en las divisiones mencionadas anteriormente. Solo estará presente si includeOffices fue verdadero en la solicitud. | |
offices[].divisionId |
string |
El ID de TOC de la división con la que se asocia esta oficina. | |
offices[].levels[] |
list |
Los niveles de gobierno del que forma parte este cargo. Puede haber más de una en los casos en los que una jurisdicción efectivamente actúe en dos niveles de gobierno diferentes; por ejemplo, el alcalde del distrito de Columbia actúa a nivel de la "localidad", pero también de manera efectiva tanto en administrativeArea2 como en administrativeArea1 .Entre los valores válidos, se incluyen los siguientes:
|
|
offices[].name |
string |
El nombre de la oficina en lenguaje natural. | |
offices[].officialIndices[] |
list |
Lista de índices en el conjunto de funcionarios de personas que actualmente ocupan este cargo. | |
offices[].roles[] |
list |
Las funciones que cumple esta oficina. Los roles no pretenden ser exhaustivos ni especificar de manera exacta todo el conjunto de responsabilidades de una oficina determinada, sino categorías aproximadas que sirven para la selección general o la ordenación de una lista de oficinas. Los valores válidos incluyen los siguientes:
|
|
offices[].sources[] |
list |
Una lista de fuentes de esta oficina. Si se enumeran varias fuentes, los datos se han agregado a partir de esas fuentes. | |
offices[].sources[].name |
string |
Es el nombre de la fuente de datos. | |
offices[].sources[].official |
boolean |
Si estos datos provienen de una fuente gubernamental oficial. |
Funcionarios electos
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
officials[] |
list |
Funcionarios que ocupan las oficinas mencionadas anteriormente. Solo estará presente si includeOffices fue verdadero en la solicitud. | |
officials[].address[] |
list |
Direcciones de contacto con el funcionario | |
officials[].address[].city |
string |
La ciudad o el pueblo de la dirección. | |
officials[].address[].line1 |
string |
El nombre de la calle y el número de esta dirección. | |
officials[].address[].line2 |
string |
En la segunda línea, escribe la dirección, si es necesario. | |
officials[].address[].line3 |
string |
La tercera línea de la dirección, si es necesario. | |
officials[].address[].locationName |
string |
Es el nombre de la ubicación. | |
officials[].address[].state |
string |
Es la abreviatura de estado de dos letras de los EE.UU. de la dirección. | |
officials[].address[].zip |
string |
Es el código postal de EE.UU. de la dirección. | |
officials[].channels[] |
list |
Una lista de canales de redes sociales (sociales) conocidos para este funcionario. | |
officials[].channels[].id |
string |
Es el identificador público único del canal del candidato. | |
officials[].channels[].type |
string |
Indica el tipo de canal. A continuación, se incluye una lista de los tipos de canales, pero no es exhaustiva. Es posible que se agreguen más tipos de canales más adelante. Una de las siguientes opciones: YouTube, Facebook o Twitter | |
officials[].emails[] |
list |
Las direcciones de correo electrónico directas del funcionario. | |
officials[].name |
string |
El nombre del funcionario. | |
officials[].party |
string |
El nombre completo del partido al que pertenece el funcionario. | |
officials[].phones[] |
list |
Los números de teléfono de contacto públicos del funcionario | |
officials[].photoUrl |
string |
La URL de una foto del funcionario. | |
officials[].urls[] |
list |
Las URLs del sitio web público del funcionario |
Métodos
- representativeInfoByAddress
- Busca la ubicación geográfica política y la información representativa de una sola dirección.
- representativeInfoByDivision
- Busca información representativa de una sola división geográfica.