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

Representatives

Esta colección incluye información sobre geografía política, así como sobre funcionarios electos.

Para obtener una lista de métodos para este recurso, consulta al 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 divisiones geográficas políticas, como un país, un estado, un condado o un distrito legislativo. (Las divisiones que se mostrarán dependerán de la solicitud específica a la API realizada). La sección offices enumera las posiciones políticas que se eligen para representar las divisiones de la primera sección. En la sección officials, se enumeran las personas que actualmente se desempeñan en las oficinas indicadas.

{
  "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 políticas que contienen la dirección solicitada.
`divisions.(key)`	`nested object`	Es el identificador de datos cívicos único de esta división.
`divisions.(key).alsoKnownAs[]`	`list`	Cualquier otro ID de OCD válido que se refiera a la misma división. Debido a que los IDs de OCD deben ser legibles y al menos algo predecibles, a veces hay varios identificadores para una sola división. Estos identificadores se definen para que sean equivalentes entre sí, y uno siempre se indica como el identificador principal. El identificador principal se mostrará en el campo ocd_id de arriba y cualquier otro identificador válido equivalente se devolverá en esta lista. Por ejemplo, si el ID de OCD de esta división es ocd-division/country:us/district:dc, verás ocd-division/country:us/state:dc.
`divisions.(key).name`	`string`	Indica el nombre de la división.
`divisions.(key).officeIndices[]`	`list`	Lista de índices en el array `offices`, uno para cada cargo elegido de esta división. Solo estará presente si `includeOffices` es verdadero (o ausente) en la solicitud.

Oficinas elegidas

Nombre de la propiedad	Valor	Descripción
`offices[]`	`list`	Oficinas elegidas a las que hacen referencia las divisiones mencionadas anteriormente. Solo estará presente si includeOffices es verdadero en la solicitud.
`offices[].divisionId`	`string`	El ID de OCD de la división con la que está asociada esta oficina.
`offices[].levels[]`	`list`	Los niveles de gobierno en los que forma parte esta oficina. Puede haber más de uno en los casos en los que una jurisdicción actúa de manera efectiva en dos niveles de gobierno diferentes. por ejemplo, el alcalde del Distrito de Columbia actúa en "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 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 los consejos vecinales asesores de Washington, D.C. `special` -- Distritos locales que existen solo para gobiernos con propósitos 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 grupo de funcionarios de personas que actualmente ocupan este cargo.
`offices[].roles[]`	`list`	Las funciones que cumple esta oficina. Las funciones no pretenden ser exhaustivas ni especificar con exactitud el conjunto completo de responsabilidades de una oficina determinada, sino que deben ser categorías aproximadas que sean útiles para la selección general o la clasificació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 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` -- El funcionario responsable de asumir el rol de jefe de Gobierno en caso de fallecimiento o incapacidad del jefe de Gobierno electo. En EE.UU., es el vicepresidente. Esta oficina también puede tener otras responsabilidades. `governmentOfficer`: un funcionario de sucursal ejecutivo electo. En los estados de EE.UU., esto puede incluir roles como procurador general, contratista, secretario o estado, o tesorero. `executiveCouncil`: Es un miembro de un consejo ejecutivo que cumple funciones de sucursal ejecutiva como grupo. Algunos ejemplos son los comisionados del condado de Indiana. `legislatorUpperBody`: Miembro de la parte superior de una legislatura bicameral o el único cuerpo de una legislatura unicameral. `legislatorLowerBody`: miembro del cuerpo inferior de una legislatura bicameral. `highestCourtJudge`: 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 presta servicio. `schoolBoard`: Es un miembro de una junta escolar local. `specialPurposeOfficer`: Corresponde a un oficial que tiene un propósito único y definido, como miembro de una junta de conservación del suelo y el agua o un oficial de reducción de mosquitos.
`offices[].sources[]`	`list`	Una lista de fuentes de esta oficina. Si se enumeran varias fuentes, los datos se agregaron a partir de ellas.
`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 es verdadero en la solicitud.
`officials[].address[]`	`list`	las direcciones donde se debe contactar al funcionario
`officials[].address[].city`	`string`	Es 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`	La segunda línea es 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 del estado de dos letras de la dirección de EE.UU.
`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`	Es el tipo de canal. Esta es una lista de los tipos de canales que no es exhaustiva. Es posible que se agreguen más tipos de canales en otro momento. Uno de los siguientes: YouTube, Facebook o Twitter
`officials[].emails[]`	`list`	Las direcciones de correo electrónico directo del funcionario.
`officials[].name`	`string`	El nombre del funcionario.
`officials[].party`	`string`	Nombre completo del partido al que pertenece el funcionario
`officials[].phones[]`	`list`	Números de teléfono de contacto público del funcionario.
`officials[].photoUrl`	`string`	La URL de la 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.