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:
|
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:
|
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. |