Representatives: representativeInfoByAddress

Cerca la geografia politica e le informazioni rappresentative di un singolo indirizzo. Prova subito.

Richiesta

Richiesta HTTP

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

Parametri

Nome del parametro Valore Descrizione
Parametri di query facoltativi
address string L'indirizzo da cercare. Può essere specificato solo se il campo ocdId non è specificato nell'URL.
includeOffices boolean Se restituire informazioni su uffici e funzionari. Se è falso, verranno restituite solo le informazioni distrettuale di primo livello. (valore predefinito: true)
levels string Un elenco di livelli di uffici in base ai quali filtrare. Saranno restituiti solo gli uffici che servono almeno uno di questi livelli. Le divisioni che non contengono un ufficio corrispondente non verranno restituite.

I valori accettati sono:
  • "administrativeArea1"
  • "administrativeArea2"
  • "country"
  • "international"
  • "locality"
  • "regional"
  • "special"
  • "subLocality1"
  • "subLocality2"
roles string Un elenco di ruoli d'ufficio in base ai quali filtrare. Verranno restituiti solo gli uffici con uno di questi ruoli. Le divisioni che non contengono un ufficio corrispondente non verranno restituite.

I valori accettati sono:
  • "deputyHeadOfGovernment"
  • "executiveCouncil"
  • "governmentOfficer"
  • "headOfGovernment"
  • "headOfState"
  • "highestCourtJudge"
  • "judge"
  • "legislatorLowerBody"
  • "legislatorUpperBody"
  • "schoolBoard"
  • "specialPurposeOfficer"

Corpo della richiesta

Non fornire il corpo di una richiesta con questo metodo.

Risposta

Se l'esito è positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:

{
  "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
        }
      ]
    }
  ]
}
Nome proprietà Valore Descrizione Note
kind string Identifica il tipo di risorsa. Valore: la stringa fissa "civicinfo#representativeInfoResponse".
normalizedInput nested object La versione normalizzata dell'indirizzo richiesto
normalizedInput.locationName string Il nome del luogo.
normalizedInput.line1 string Il nome e il numero della via dell'indirizzo.
normalizedInput.line2 string La seconda riga dell'indirizzo, se necessario.
normalizedInput.line3 string La terza riga dell'indirizzo, se necessario.
normalizedInput.city string La città dell'indirizzo.
normalizedInput.state string L'abbreviazione dello stato a due lettere dell'indirizzo statunitense.
normalizedInput.zip string Il codice postale statunitense dell'indirizzo.
divisions object Divisioni geografiche politiche che contengono l'indirizzo richiesto. Per maggiori dettagli, consulta la documentazione relativa alle risorse per i rappresentanti.
offices[] list Uffici eletti a cui fanno riferimento le divisioni sopra elencate. Sarà presente solo se includeOffices è true nella richiesta. Per maggiori dettagli, consulta la documentazione relativa alle risorse per i rappresentanti.
officials[] list Funzionari che ricoprono le cariche sopra elencate. Sarà presente solo se includeOffices è true nella richiesta. Per maggiori dettagli, consulta la documentazione relativa alle risorse per i rappresentanti.

Prova.