Questa pagina è stata tradotta dall'API Cloud Translation.

Representatives

Questa raccolta include informazioni sull'area geografica politica e sui funzionari eletti.

Per un elenco di metodi per questa risorsa, vai alla fine di questa pagina.

Rappresentazioni delle risorse

Una risorsa in questa raccolta ha tre sezioni, descritte in dettaglio di seguito. La sezione divisions elenca divisioni geografiche politiche, ad esempio un paese, uno stato, una contea o un distretto legislativo. Le divisioni elencate dipendono dalla specifica richiesta API effettuata. La sezione offices elenca le posizioni politiche che vengono scelte per rappresentare le divisioni nella prima sezione. La sezione officials elenca le persone che attualmente prestano servizio negli uffici elencati.

{
  "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
        }
      ]
    }
  ]
}

Geografia politica

Nome proprietà	Valore	Descrizione
`divisions`	`object`	Divisioni geografiche politiche che contengono l'indirizzo richiesto.
`divisions.(key)`	`nested object`	L'identificatore univoco dei dati civici di apertura di questa divisione.
`divisions.(key).alsoKnownAs[]`	`list`	Qualsiasi altro ID OCD valido che faccia riferimento alla stessa divisione. Poiché gli ID OCD sono pensati per essere leggibili da una persona e almeno piuttosto prevedibili, a volte ci sono diversi identificatori per una singola divisione. Questi identificatori si definiscono equivalenti tra loro e uno è sempre indicato come identificatore principale. L'identificatore principale verrà restituito in ocd_id sopra, mentre qualsiasi altro identificatore valido equivalente verrà restituito in questo elenco. Ad esempio, se l'ID OCD di questa divisione è ocd-division/country:us/district:dc, conterrà ocd-division/country:us/state:dc.
`divisions.(key).name`	`string`	Il nome della divisione.
`divisions.(key).officeIndices[]`	`list`	Elenco di indici nell'array `offices`, uno per ogni carica elettiva per questa divisione. Sarà presente solo se `includeOffices` era true (o assente) nella richiesta.

Uffici eletti

Nome proprietà	Valore	Descrizione
`offices[]`	`list`	Uffici eletti a cui fanno riferimento le divisioni sopra elencate. Sarà presente solo se includeOffices nella richiesta è impostato su true.
`offices[].divisionId`	`string`	L'ID OCD della divisione a cui è associato questo ufficio.
`offices[].levels[]`	`list`	I livelli di governo a cui fa parte questo ufficio. Potrebbe esservi più di un caso in cui una giurisdizione agisce effettivamente a due diversi livelli di governo; Ad esempio, il sindaco del District of Columbia agisce in "località" a livello di progetto, ma anche in modo efficace sia a `administrativeArea2` che a `administrativeArea1`. I valori validi sono: `international` -- Governi internazionali, come le Nazioni Unite o l'Unione Europea. `country` -- Governi a livello nazionale, come il governo federale degli Stati Uniti. `administrativeArea1`: governi della suddivisione amministrativa di primo livello di un paese, ad esempio gli stati USA. `regional` -- Amministrazioni regionali la cui giurisdizione può attraversare suddivisioni amministrative standard; sono rari negli Stati Uniti, ma sono comuni nelle grandi città di altri paesi. `administrativeArea2`. Governi della suddivisione amministrativa di secondo livello di un paese, ad esempio le contee degli Stati Uniti. `locality` -- Amministrazioni municipali o comunali. `subLocality1` -- Governi della suddivisione amministrativa di primo livello di una città, ad esempio i quartieri di Washington, DC. `subLocality2` - Governi della suddivisione amministrativa di secondo livello di una città,ad esempio i consigli del quartiere consultivo di Washington, DC. `special`: distretti locali riservati a enti con scopi specifici, come i distretti per la conservazione del suolo e dell'acqua.
`offices[].name`	`string`	Il nome leggibile dell'ufficio.
`offices[].officialIndices[]`	`list`	Elenco degli indici della serie di funzionari che ricoprono attualmente questa carica.
`offices[].roles[]`	`list`	I ruoli che questo ufficio ricopre. I ruoli non devono essere esaustivi o specificare esattamente l'intero insieme di responsabilità di un determinato ufficio, ma sono categorie indicative utili per la selezione generale o l'ordinamento di un elenco di uffici. I valori validi includono: `headOfState` . Il primo rappresentante pubblico di un governo. Il capo di stato di un paese di solito viene chiamato Presidente. `headOfGovernment`: l'amministratore delegato di un governo. Negli Stati Uniti, è il Presidente; in altri paesi, spesso è il primo ministro. Ai livelli inferiori potrebbe essere un governatore o un sindaco. `deputyHeadOfGovernment` -- L'ufficiale responsabile dell'assunzione del ruolo di capo del governo in caso di decesso o di incapacità del capo del governo eletto. Negli Stati Uniti, è il vicepresidente. Questo ufficio potrebbe avere anche altre mansioni. `governmentOfficer`: un funzionario del ramo esecutivo eletto. Negli stati USA, possono essere inclusi ruoli quali Procuratore Generale, Controllore, Segretario, Stato o Tesoriere. `executiveCouncil`: membro di un comitato esecutivo che ricopre ruoli dirigenziali come gruppo. Un esempio sono i commissari della contea dell'Indiana. `legislatorUpperBody`: membro della parte superiore di un corpo legislativo bicamerale o unico organo di un corpo legislativo unicamerale. `legislatorLowerBody`: membro della parte inferiore di un corpo legislativo bicamerale. `highestCourtJudge`. Un giudice di un tribunale di un determinato governo, ad esempio una Corte Suprema dello stato. `judge` -- Un giudice in qualsiasi tribunale diverso da quello della parte superiore del governo al quale serve. `schoolBoard`: membro di un comitato scolastico locale. `specialPurposeOfficer`: un funzionario che persegue un singolo scopo definito, ad esempio un membro di un comitato per la conservazione del suolo e dell'acqua o un funzionario che si occupa dell'abbattimento delle zanzare.
`offices[].sources[]`	`list`	Un elenco di fonti per questo ufficio. Se sono elencate più origini, i dati sono stati aggregati a partire da queste origini.
`offices[].sources[].name`	`string`	Il nome dell'origine dati.
`offices[].sources[].official`	`boolean`	Se questi dati provengono da una fonte governativa ufficiale.

Funzionari eletti

Nome proprietà	Valore	Descrizione
`officials[]`	`list`	Funzionari che ricoprono le cariche sopra elencate. Sarà presente solo se includeOffices nella richiesta è impostato su true.
`officials[].address[]`	`list`	Indirizzi a cui contattare il funzionario.
`officials[].address[].city`	`string`	La città dell'indirizzo.
`officials[].address[].line1`	`string`	Il nome della via e il numero di questo indirizzo.
`officials[].address[].line2`	`string`	La seconda riga l'indirizzo, se necessario.
`officials[].address[].line3`	`string`	La terza riga dell'indirizzo, se necessario.
`officials[].address[].locationName`	`string`	Il nome della località.
`officials[].address[].state`	`string`	L'abbreviazione di due lettere dell'indirizzo negli Stati Uniti.
`officials[].address[].zip`	`string`	Il codice postale statunitense dell'indirizzo.
`officials[].channels[]`	`list`	Un elenco dei canali di media (social) noti di questo funzionario.
`officials[].channels[].id`	`string`	L'identificatore pubblico univoco del canale del candidato.
`officials[].channels[].type`	`string`	Il tipo di canale. Di seguito è riportato un elenco di tipi di canali, ma non è esaustivo. In un secondo momento potrebbero essere aggiunti altri tipi di canali. Uno dei seguenti: YouTube, Facebook, Twitter
`officials[].emails[]`	`list`	Gli indirizzi email diretti del funzionario.
`officials[].name`	`string`	Il nome del funzionario.
`officials[].party`	`string`	Il nome completo della parte a cui appartiene il funzionario.
`officials[].phones[]`	`list`	I numeri di telefono di contatto pubblici del funzionario.
`officials[].photoUrl`	`string`	Un URL per una foto del funzionario.
`officials[].urls[]`	`list`	Gli URL del sito web pubblico del funzionario.

Metodi

representativeInfoByAddress: Cerca informazioni geografiche e rappresentative politiche per un singolo indirizzo.
representativeInfoByDivision: Cerca informazioni rappresentative di una singola divisione geografica.