Representatives: representativeInfoByAddress

Busca la ubicación geográfica política y la información representativa de una sola dirección. Pruébalo ahora.

Solicitud

Solicitud HTTP

GET https://www.googleapis.com/civicinfo/v2/representatives

Parámetros

Nombre del parámetro Valor Descripción
Parámetros de consulta opcionales
address string La dirección que se debe buscar. Solo se puede especificar si el campo ocdId no es proporcionadas en la URL.
includeOffices boolean Si se debe devolver información sobre oficinas y funcionarios. Si es falso, solo se devolverá la información del distrito de nivel superior. (Predeterminado: true)
levels string Una lista de niveles de oficina para filtrar. Solo las oficinas que tienen, al menos, uno de estos niveles. Divisiones que no contienen un oficina correspondiente no se devolverá.

Los valores aceptables son los siguientes:
  • "administrativeArea1"
  • "administrativeArea2"
  • "country"
  • "international"
  • "locality"
  • "regional"
  • "special"
  • "subLocality1"
  • "subLocality2"
roles string Una lista de puestos de oficina para filtrar. Solo las oficinas que cumplen con uno de se devolverán estos roles. Divisiones que no contienen coincidencias oficina no devolverán.

Los valores aceptables son los siguientes:
  • "deputyHeadOfGovernment"
  • "executiveCouncil"
  • "governmentOfficer"
  • "headOfGovernment"
  • "headOfState"
  • "highestCourtJudge"
  • "judge"
  • "legislatorLowerBody"
  • "legislatorUpperBody"
  • "schoolBoard"
  • "specialPurposeOfficer"

Cuerpo de la solicitud

No proporciones un cuerpo de la solicitud con este método.

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

{
  "kind": "civicinfo#representativeInfoResponse",
  "normalizedInput": {
    "locationName": string,
    "line1": string,
    "line2": string,
    "line3": string,
    "city": string,
    "state": string,
    "zip": string
  },
  "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
        }
      ]
    }
  ]
}
Nombre de la propiedad Valor Descripción Notas
kind string Identifica qué tipo de recurso es. Valor: la cadena fija "civicinfo#representativeInfoResponse"
normalizedInput nested object La versión normalizada de la dirección solicitada
normalizedInput.locationName string Es el nombre de la ubicación.
normalizedInput.line1 string El nombre de la calle y el número de esta dirección
normalizedInput.line2 string La segunda línea es la dirección, si es necesario.
normalizedInput.line3 string La tercera línea de la dirección, si es necesario.
normalizedInput.city string Es la ciudad o el pueblo de la dirección.
normalizedInput.state string Es la abreviatura del estado de dos letras de la dirección de EE.UU.
normalizedInput.zip string Es el código postal de EE.UU. de la dirección.
divisions object Divisiones geográficas políticas que contienen la información solicitada web. Para obtener más detalles, consulta los Representantes recurso.
offices[] list Oficinas elegidas a las que hacen referencia las divisiones mencionadas anteriormente. Testamento solo debe estar presente si includeOffices era verdadero en la solicitud. Para obtener más detalles, consulta los Representantes recurso.
officials[] list Funcionarios que ocupan las oficinas mencionadas anteriormente Solo estará presente si includeOffices era verdadero en la solicitud. Para obtener más detalles, consulta los Representantes recurso.

Pruébalo