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 no se proporciona el campo ocdId en la URL.
includeOffices boolean Si debe devolver información sobre oficinas y funcionarios. Si es falso, solo se mostrará la información del distrito de nivel superior. (Predeterminado: true)
levels string Una lista de niveles de oficina para filtrar. Solo se devolverán las oficinas que prestan servicios en al menos uno de estos niveles. No se mostrarán las divisiones que no contengan una oficina que coincida.

Los valores aceptables son los siguientes:
  • "administrativeArea1"
  • "administrativeArea2"
  • "country"
  • "international"
  • "locality"
  • "regional"
  • "special"
  • "subLocality1"
  • "subLocality2"
roles string Una lista de roles de oficina para filtrar. Solo se devolverán las oficinas que cumplan uno de estos roles. No se mostrarán las divisiones que no contengan una oficina que coincida.

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 este. Valor: la string 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 En la segunda línea, escribe la dirección, si es necesario.
normalizedInput.line3 string La tercera línea de la dirección, si es necesario.
normalizedInput.city string La ciudad o el pueblo de la dirección.
normalizedInput.state string Es la abreviatura de estado de dos letras de los EE.UU. de la dirección.
normalizedInput.zip string Es el código postal de EE.UU. de la dirección.
divisions object Divisiones geográficas geográficas que contienen la dirección solicitada. Para obtener más detalles, consulta la documentación sobre recursos para representantes.
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. Para obtener más detalles, consulta la documentación sobre recursos para representantes.
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 la documentación sobre recursos para representantes.

Pruébalo