Representatives: representativeInfoByAddress

Cerca informazioni geografiche e rappresentative per 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 è indicato nell'URL.
includeOffices boolean Indica se restituire informazioni su uffici e funzionari. Se false, viene utilizzato verranno restituite le informazioni sul distretto di primo livello. (Valore predefinito: true)
levels string Un elenco di livelli di ufficio in base ai quali filtrare. Solo uffici con almeno servizio di assistenza verrà restituito uno di questi livelli. Divisioni che non contengono un per l'ufficio corrispondente non verrà restituito.

I valori accettati sono:
  • "administrativeArea1"
  • "administrativeArea2"
  • "country"
  • "international"
  • "locality"
  • "regional"
  • "special"
  • "subLocality1"
  • "subLocality2"
roles string Un elenco di ruoli di ufficio in base ai quali filtrare. Solo gli uffici che soddisfano uno di questi verranno restituiti questi ruoli. Divisioni che non contengono una corrispondenza non verrà restituito.

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

Corpo della richiesta

Non fornire un corpo della richiesta con questo metodo.

Risposta

In caso di 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 di che tipo di risorsa si tratta. Valore: la stringa fissa "civicinfo#representativeInfoResponse".
normalizedInput nested object La versione normalizzata dell'indirizzo richiesto
normalizedInput.locationName string Il nome della località.
normalizedInput.line1 string Il nome della via e il numero di questo indirizzo.
normalizedInput.line2 string La seconda riga l'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 di due lettere dell'indirizzo negli Stati Uniti.
normalizedInput.zip string Il codice postale statunitense dell'indirizzo.
divisions object Divisioni geografiche politiche che contengono . Per ulteriori dettagli, vedi i rappresentanti Google Cloud.
offices[] list Uffici eletti a cui fanno riferimento le divisioni sopra elencate. Marco sarà presente solo se includeOffices era true nella richiesta. Per ulteriori dettagli, vedi i rappresentanti Google Cloud.
officials[] list Funzionari che ricoprono le cariche sopra elencate. Sarà presente solo se includeOffices fosse true nella richiesta. Per ulteriori dettagli, vedi i rappresentanti Google Cloud.

Prova