Se usó la API de Cloud Translation para traducir esta página.

Representatives

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
`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
`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: `international` -- Gobiernos internacionales, como las Naciones Unidas o la Unión Europea. `country` -- Gobiernos nacionales, como el Gobierno Federal de EE.UU. `administrativeArea1`: Gobiernos de la subdivisión administrativa de nivel superior de un país, como los estados de EE.UU. `regional`: Gobiernos regionales cuya jurisdicción puede cruzar las subdivisiones administrativas estándares. No son comunes en EE.UU., pero son comunes en ciudades grandes de otros países. `administrativeArea2`: Gobiernos de la subdivisión administrativa de segundo nivel de un país, como los condados de EE.UU. `locality` -- Gobiernos municipales o municipales. `subLocality1`: Gobiernos de la subdivisión administrativa de nivel superior de una ciudad, como los distritos de Washington, D. C. `subLocality2` -- Gobiernos de la subdivisión administrativa de segundo nivel de una ciudad,como Washington, DC. `special`: Son distritos locales que solo existen para gobiernos con fines especiales, como los distritos de conservación del suelo y el agua.
`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: `headOfState` -- El principal representante público de un Gobierno. Por lo general, el jefe de estado de un país se denomina presidente. `headOfGovernment`: El director ejecutivo de un Gobierno. En los EE. UU., es el presidente; en otros países, suele ser el primer ministro. En los niveles inferiores, podría ser gobernador o alcalde. `deputyHeadOfGovernment`: Funcionario responsable de asumir la función de jefe de Gobierno en caso de muerte o incapacidad del jefe de Gobierno electo En EE.UU., es el vicepresidente. Esta oficina también puede tener otras funciones. `governmentOfficer`: Funcionario electo de la rama ejecutiva. En los estados de EE.UU., esto puede incluir cargos como procurador general, controlador, secretario, estado o tesorero. `executiveCouncil`: Es un miembro de un consejo ejecutivo que cumple las funciones de rama ejecutiva como grupo. Algunos ejemplos son los comisionados del condado de Indiana. `legislatorUpperBody`: Miembro del cuerpo superior de una legislatura bicámara o único órgano de una legislatura unicámara. `legislatorLowerBody`: Miembro del cuerpo inferior de una legislatura bicámara. `highestCourtJudge`: Es un juez del tribunal superior de un gobierno en particular, como una Corte Suprema estatal. `judge` -- Un juez de cualquier tribunal que no sea el tribunal superior del Gobierno al que ejerza su servicio `schoolBoard`: Eres miembro de una junta escolar local. `specialPurposeOfficer`: Funcionario que cumple con un propósito único y definido, por ejemplo, miembro de una junta de conservación del suelo y el agua o un agente de control de mosquitos.
`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
`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.